> ## Documentation Index
> Fetch the complete documentation index at: https://docs.siftly.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect to ChatGPT & Claude (MCP)

> Connect Siftly to ChatGPT, Claude, and other AI assistants over MCP — then ask for your GEO data and run Siftly actions in plain language.

Siftly runs a hosted **MCP server**. It lets AI assistants like ChatGPT and Claude read your GEO data and run Siftly actions in plain language — "What's my share of voice this week?" or "Draft a reply for today's top Reddit opportunity." You connect once with a URL, sign in with your Siftly account, and your assistant does the rest.

MCP (Model Context Protocol) is the open standard these assistants use to reach outside tools. Siftly's server works with any MCP-compatible client.

<Info>
  **Siftly MCP server URL**

  ```
  https://mcp.siftly.ai/mcp
  ```

  This is the only value you paste. No API key, client ID, or client secret — sign-in uses your existing Siftly login.
</Info>

## Prerequisites

* A Siftly account with an **active subscription**. The server declines workspaces with no active plan.
* An AI client that supports **remote MCP connectors** (see the tabs below).

## Connection Details

| Setting           | Value                                                |
| ----------------- | ---------------------------------------------------- |
| Server URL        | `https://mcp.siftly.ai/mcp`                          |
| Transport         | Streamable HTTP (remote)                             |
| Authentication    | OAuth — sign in with your Siftly account             |
| Setup credentials | None — the connection registers itself automatically |

When your client first reaches the server, Siftly returns the sign-in details and your client opens a Siftly login page. Approve access once, and the client refreshes its own access from then on.

## Connect Your Client

<Tabs>
  <Tab title="ChatGPT">
    Custom MCP connectors need **developer mode**. It's available on ChatGPT Plus, Pro, Business, Enterprise, and Education, in the web app. On Business, Enterprise, and Education, a workspace admin enables connectors first.

    <Steps>
      <Step title="Enable developer mode">
        Open ChatGPT on the web. Go to **Settings → Apps → Advanced settings** and turn on **Developer mode**.
      </Step>

      <Step title="Add the connector">
        In a chat, open the **+** menu, choose **Developer mode**, then **Add**. Paste `https://mcp.siftly.ai/mcp` as the server URL and continue.
      </Step>

      <Step title="Sign in to Siftly">
        Approve access on the Siftly sign-in page. ChatGPT returns to your chat once connected.
      </Step>

      <Step title="Turn Siftly on for the chat">
        Open the **+** menu and enable **Siftly** for the conversation.
      </Step>
    </Steps>

    <Note>
      ChatGPT reaches only public HTTPS servers. Use the `https://mcp.siftly.ai/mcp` URL — not a local address.
    </Note>
  </Tab>

  <Tab title="Claude">
    **Pro or Max**

    <Steps>
      <Step title="Open Connectors">
        In Claude on the web, go to **Settings → Connectors** (also shown under **Customize → Connectors**).
      </Step>

      <Step title="Add a custom connector">
        Choose **Add custom connector** and paste `https://mcp.siftly.ai/mcp` as the remote MCP server URL.
      </Step>

      <Step title="Connect and sign in">
        Choose **Connect** and sign in with your Siftly account.
      </Step>
    </Steps>

    <Note>
      Leave the OAuth client ID and secret blank under **Advanced settings** — the server registers your client for you.
    </Note>

    **Team or Enterprise**

    An **Owner** or **Primary Owner** adds the connector once, under organization **Settings → Connectors → Add custom connector**, using the same URL. Each member then connects and signs in with their own Siftly account.
  </Tab>

  <Tab title="Claude Code">
    Add Siftly as a remote MCP server from the CLI:

    ```bash theme={null}
    claude mcp add --transport http siftly https://mcp.siftly.ai/mcp
    ```

    Then run `/mcp` inside Claude Code and choose **Authenticate** to sign in with your Siftly account.
  </Tab>

  <Tab title="Other clients">
    Any client that supports remote MCP over Streamable HTTP works. For clients that support only local (stdio) servers, bridge to the remote server with `mcp-remote`:

    ```json theme={null}
    {
      "mcpServers": {
        "siftly": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://mcp.siftly.ai/mcp"]
        }
      }
    }
    ```

    The bridge opens a browser window for the same Siftly sign-in on first use.
  </Tab>
</Tabs>

## Choose Your Workspace

The connection defaults to your **active** Siftly workspace. If you belong to more than one:

* Ask your assistant to **"list my Siftly organizations"** to see every workspace, your role, and which one is active.
* Then name the workspace in your request — for example, "get brand metrics for Acme Corp." Every response echoes the workspace it used, so you can confirm the scope.

## Verify the Connection

Ask your assistant: **"Who am I connected to Siftly as?"** It returns your account, workspace, and access level. A clean response confirms sign-in, workspace, and data access are all working.

## What You Can Ask

Reads are available to everyone in the workspace. Writes depend on your role, and any paid or outward action asks you to confirm first.

| Area             | Ask for…                                                                            |
| ---------------- | ----------------------------------------------------------------------------------- |
| Visibility       | Coverage, share of voice, and average rank, with the change vs. the previous period |
| Leaderboard      | How you rank against competitors by topic, engine, or location                      |
| Citations        | Which domains and pages cite your brand in AI answers                               |
| Prompts & topics | The AI queries you track and how your brand performs on each                        |
| Content          | Recommendations, drafts, and full articles — and publishing them                    |
| Search & traffic | Google Search Console performance and AI crawler activity on your site              |
| Reddit           | Today's engagement queue, suggested replies, and streaks                            |
| Account roll-up  | A one-call summary for a meeting: visibility, blogs, Reddit, and outreach           |

**Example prompts**

* "What's my coverage and share of voice over the last 7 days versus the week before?"
* "Show my top cited domains and the pages they link to."
* "Summarize my Siftly account for a call."
* "Draft a Reddit reply for today's top opportunity." *(drafts only — see below)*

## Permissions, Spend & Safety

* **Reads are open** to any member of the workspace.
* **Writes follow your role.** Members get reversible changes; admins and owners get the full set.
* **Paid and outward actions confirm first.** Generating an article, running analysis, publishing, and deletes show a preview and wait for your approval before anything runs or is charged.
* **Nothing posts on your behalf.** The Reddit and LinkedIn tools draft and mark items as published — they never post to Reddit or LinkedIn for you.

<Warning>
  Limits apply per workspace: up to 120 requests per minute, and up to 50 paid AI runs per day. You'll see a clear message if you reach either.
</Warning>

## Troubleshooting

<AccordionGroup>
  <Accordion title="It says my subscription is required">
    The workspace has no active Siftly plan. Activate a plan, or switch to a workspace that has one. Ask your assistant to "list my Siftly organizations" to see which workspaces are entitled.
  </Accordion>

  <Accordion title="I'm asked to sign in again, or I get an authorization error">
    The stored access expired or was revoked. Reconnect the Siftly connector in your client and sign in again.
  </Accordion>

  <Accordion title="It can't reach a workspace I named">
    You can only reach workspaces you belong to. Use a name or ID from "list my Siftly organizations," then keep naming that workspace until you switch.
  </Accordion>

  <Accordion title="I hit a rate limit or spend cap">
    You've passed 120 requests in a minute, or 50 paid AI runs in a day, for the workspace. Wait about a minute for the rate limit, or until the next day for the spend cap.
  </Accordion>

  <Accordion title="The connector won't add">
    Confirm the URL is exactly `https://mcp.siftly.ai/mcp`, and that your plan supports custom connectors. ChatGPT needs developer mode; Claude needs Pro, Max, Team, or Enterprise.
  </Accordion>

  <Accordion title="A large workspace responds slowly">
    Some metric queries scale with workspace size. Narrow the request — a shorter period, or a single brand — and try again.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Set up your brand and run your first GEO analysis.
  </Card>

  <Card title="Brand Visibility" icon="chart-bar" href="/features/brand-visibility">
    Understand coverage, share of voice, and rank.
  </Card>

  <Card title="Citation Analysis" icon="quote-left" href="/features/citation-analysis">
    See exactly where AI answers cite your brand.
  </Card>

  <Card title="AI Bot Traffic Tracking" icon="robot" href="/traffic-tracking/overview">
    Track which AI crawlers read your site.
  </Card>
</CardGroup>