Getting Started

Connect your AI assistant to Tycana in under a minute.

1. Create an account

Sign up at app.tycana.com — we’ll send you a magic link, no password needed. The free tier gives you everything you need to get started.

2. Connect your AI assistant

Pick the app you use. The setup is slightly different for each one.

Claude.ai

Best for browser-based use. Uses OAuth — no tokens to manage.

1. Log in to app.tycana.com, go to OAuth Clients, and create a new client.

2. Copy the Client ID and Client Secret — the secret is shown once.

3. In Claude.ai, add Tycana as a remote MCP server:

• Server URL: https://app.tycana.com/mcp
• Client ID: (from your dashboard)
• Client Secret: (from your dashboard)

4. Approve the consent screen in your browser — you’re connected.

Claude Code

Best for terminal use. One command.

1. Log in to app.tycana.com, go to Personal Tokens, and generate a new token. Copy it — it starts with tyk_ and is only shown once.

2. Run:

claude mcp add tycana \
  --transport streamable-http \
  https://app.tycana.com/mcp \
  --header "authorization: Bearer YOUR_TOKEN_HERE"

That’s it.

Claude Desktop

1. Generate a personal token from app.tycana.com (same as Claude Code above).

2. Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "tycana": {
      "type": "streamable-http",
      "url": "https://app.tycana.com/mcp",
      "headers": {
        "authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

Config file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Restart Claude Desktop after saving.

Other apps

Any app that supports MCP with Streamable HTTP will work — including ChatGPT, Cursor, and GitHub Copilot. Use a personal token (same as above) with:

• Server URL: https://app.tycana.com/mcp
• Auth: Bearer token in the authorization header

3. Try it

Once connected, just talk to your AI naturally:

• “Add a task to finish the client proposal by Thursday”
• “What’s on my plate today?”
• “Plan my afternoon”
• “Remind me to book the dentist for the kids”
• “What should I focus on next?”
• “Show me everything due this week”

You don’t need to learn any commands or special syntax. Your AI figures out the rest.

Troubleshooting

“Authentication failed” — For personal tokens, check that it includes the tyk_ prefix. For OAuth, verify your Client ID and Secret. You can generate new credentials from app.tycana.com at any time.

“Connection refused” — Make sure the URL is https://app.tycana.com/mcp (not /api/mcp or other variations).

Tools not appearing — Restart your AI assistant after adding the configuration. Claude Desktop requires a full restart.

OAuth consent screen not appearing — Make sure you’re logged into app.tycana.com in your browser first.

Token expired — Personal tokens are valid for 90 days. Generate a new one from your dashboard and update your configuration.

Questions? hello@tycana.com