# Connect the MCP server to your AI client (https://snitchfeed.com/docs/mcp/setup)

The SnitchFeed MCP server uses **OAuth** for authorization. The first time you connect a client, it opens your browser on a SnitchFeed sign-in page. After you grant access, the client stores a token and reconnects on its own.

**Server URL:** `https://api.snitchfeed.com/mcp`

<McpClientIcons />

## Claude (desktop and web) [#claude-desktop-and-web]

In Claude, open **Customize** from the top-right menu, go to **Connectors**, and click **+**. Paste the server URL, give it a name (for example "SnitchFeed"), and click **Add**. The OAuth flow opens in your browser.

```
https://api.snitchfeed.com/mcp
```

This works for both Claude Desktop and claude.ai.

## Claude Code [#claude-code]

Run this command in your terminal:

```bash
claude mcp add SnitchFeed --transport http https://api.snitchfeed.com/mcp
```

This adds SnitchFeed globally to Claude Code. To scope it to the current project only, add `--scope project`.

## Cursor [#cursor]

Add the following to `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "SnitchFeed": {
      "url": "https://api.snitchfeed.com/mcp"
    }
  }
}
```

After saving, reload the window with `Cmd+Shift+P` → **Reload Window**. You can also add it from **Cursor Settings → MCP**.

## ChatGPT [#chatgpt]

<Callout type="info">
  ChatGPT needs **Developer Mode** turned on in your ChatGPT settings before you can add a connector.
</Callout>

Go to **Settings → Apps → Create**, paste the server URL, and select **OAuth Authentication**.

## Windsurf [#windsurf]

Add the following to `~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "SnitchFeed": {
      "serverUrl": "https://api.snitchfeed.com/mcp"
    }
  }
}
```

Windsurf uses `serverUrl` instead of `url`. Restart Windsurf after saving.

## OpenAI Codex [#openai-codex]

Add the following to `~/.codex/config.toml`:

```toml
[mcp_servers.SnitchFeed]
url = "https://api.snitchfeed.com/mcp"
```

No restart needed. The Codex CLI and the IDE extension share this config.

## Antigravity [#antigravity]

Add the following to your Antigravity MCP config:

```json
{
  "mcpServers": {
    "SnitchFeed": {
      "serverUrl": "https://api.snitchfeed.com/mcp"
    }
  }
}
```

## Check the connection [#check-the-connection]

1. Ask your client something that needs SnitchFeed data, for example "How many keywords am I using in SnitchFeed?". The client should call `snitchfeed_get_usage` and answer with your keyword, listener and credit usage.
2. In SnitchFeed, open **Integrations → MCP** ([app.snitchfeed.com/integrations/mcp](https://app.snitchfeed.com/integrations/mcp)). On the **Connect** tab, **Connected agents** lists every client that has authorized access, with when it connected and when it was last used. Click **Disconnect** to revoke a client.
3. The **Logs** tab shows the history of MCP requests from connected clients: time, method, status, HTTP code and duration. Expand a row for details. Logs need a plan that includes API access.

## Troubleshooting [#troubleshooting]

**The OAuth window does not open.** Make sure your client version supports the MCP Streamable HTTP transport with OAuth. Older versions may only support stdio or SSE transports.

**Tools are not appearing after connecting.** Disconnect and reconnect the server, or restart the client. The client fetches the tool list when it connects.

**Authorization expires.** Access tokens last 1 hour and the client refreshes them automatically. The refresh token lasts 30 days from when you first authorized the client and is not extended on use, so after 30 days remove and re-add the server in your client to sign in again.

**A tool returns a plan error.** Some tools need a plan feature, such as webhooks. The error includes a link to your billing page.

## Related [#related]

- [MCP concepts](/docs/mcp/concepts): what listeners, queries, mentions and Fit Score mean
- [MCP tools reference](/docs/mcp/tools): every tool and what it costs
- [MCP use cases](/docs/mcp/use-cases): prompts to try once you are connected
