MCP Setup Guide

Connect your AI tool to CatchIntent in under a minute. Choose your tool below for specific instructions.

MCP Server URL

All clients connect to the same endpoint:

https://engine.catchintent.com/mcp

Setup Instructions

Claude Code

1. Run the setup command

   Open your terminal and run:

   claude mcp add catchintent --transport http https://engine.catchintent.com/mcp

2. Start a conversation

   In your next Claude Code session, ask something like:

   Show me my CatchIntent signals from this week

3. Authorize access

   Your browser will open automatically. Log in to CatchIntent (if needed), select your workspace, and click Authorize.

4. Done!

   Claude Code now has access to your CatchIntent data. The authorization persists across sessions.

Claude Desktop

1. Open Settings

   Click the settings icon in Claude Desktop.

2. Go to Connectors

   Navigate to the Connectors section.

3. Add Custom Connector

   Click Add custom connector and enter:

   • URL: https://engine.catchintent.com/mcp

4. Connect & Authorize

   Click Connect. Your browser will open for authorization. Log in, select your workspace, and click Authorize.

5. Done!

   CatchIntent tools are now available in your Claude Desktop conversations.

Cursor

1. Open Settings

   Press Cmd+, (Mac) or Ctrl+, (Windows) to open Cursor settings.

2. Go to MCP

   Navigate to the MCP section.

3. Add MCP Server

   Click Add new MCP server and configure:

   • Type: http
   • URL: https://engine.catchintent.com/mcp

4. Save & Authorize

   Save the configuration. When you first use a CatchIntent tool, your browser will open for authorization.

Windsurf

Add the following to your MCP configuration file:

{
  "mcpServers": {
    "catchintent": {
      "serverUrl": "https://engine.catchintent.com/mcp"
    }
  }
}

When you first use a CatchIntent tool, your browser will open for authorization.

ChatGPT

1. Open Settings

   Open ChatGPT settings.

2. Go to Connections

   Navigate to the Connections or MCP section.

3. Add Connection

   Click Add connection and enter:

   • URL: https://engine.catchintent.com/mcp

4. Authorize

   Follow the OAuth prompt to log in and authorize access.

Codex

1. Run the setup command

   codex mcp add catchintent --transport http https://engine.catchintent.com/mcp

2. Authorize

   When prompted, your browser will open for authorization.

Copilot

Add to your VS Code MCP config (.vscode/mcp.json):

{
  "mcpServers": {
    "catchintent": {
      "url": "https://engine.catchintent.com/mcp"
    }
  }
}

When you first use a CatchIntent tool, your browser will open for authorization.

Other Clients

Any MCP-compatible client can connect to CatchIntent using the Streamable HTTP transport:

• Endpoint: https://engine.catchintent.com/mcp
• Transport: Streamable HTTP (POST)
• Auth: OAuth 2.1 with PKCE

The server exposes standard OAuth discovery endpoints:

• /.well-known/oauth-protected-resource
• /.well-known/oauth-authorization-server

Your client should handle the OAuth flow automatically.

Authorization

When you first use CatchIntent through an AI tool, you’ll go through a one-time OAuth authorization:

1. Your browser opens to the CatchIntent authorization page
2. Log in if you’re not already signed in
3. Select which workspace to connect (auto-selected if you only have one)
4. Review the permissions and click Authorize
5. Your AI tool receives an access token — you’re connected

Note

Authorization tokens refresh automatically. You won’t need to re-authorize unless you revoke access.

Permissions

When you authorize, CatchIntent grants access based on your workspace role:

Permission	Member	Admin	Owner
View signals, people, listeners	Yes	Yes	Yes
View workspace stats	Yes	Yes	Yes
Generate AI responses	Yes	Yes	Yes
Export people to CSV	Yes	Yes	Yes
Update signal/person status	No	Yes	Yes
Create/edit/toggle listeners	No	Yes	Yes
Trigger enrichment	No	Yes	Yes
Push to CRM	No	Yes	Yes

Managing Connections

To view or revoke connected apps:

1. Go to Settings > Agents in your CatchIntent dashboard
2. You’ll see all connected apps with connection dates
3. Click Revoke to disconnect an app

Revoking access is immediate — the app will need to re-authorize to regain access.

Troubleshooting

“Permission denied” error

Your workspace role doesn’t have access to that action. Contact your workspace admin to upgrade your role, or use read-only tools.

Authorization page doesn’t load

Make sure you’re logged into CatchIntent in your browser. Try opening https://app.catchintent.com first.

Tools not appearing

Restart your AI tool after adding the MCP configuration. Some clients need a restart to discover new MCP servers.

“Feature not available on your plan” error

Some tools require specific plan features (e.g., response suggestions on Pro+, CRM sync on Pro+). Check your plan in Settings > Billing.