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

# Connect your agent

> Add the Sumvin connector to Claude, ChatGPT, ChatGPT Work, Claude Code, OpenClaw or Hermes Agent, then sign in.

export const waitlists = {
  earlyAccess: "",
  payments: "",
  openBanking: "",
  developers: "",
  verifiers: ""
};

<Note>
  **Private preview:** this is rolling out and may not be available on your account yet.{waitlists.earlyAccess ? <> <a href={waitlists.earlyAccess}>Request early access →</a></> : null}
</Note>

Sumvin is a connector your agent talks to. Every client uses the same address:

```text theme={null}
https://mcp.sumvin.com/mcp
```

This is the recommended way to use Sumvin. Building or experimenting from a terminal? Developers can use the [CLI](/get-started/cli/install) instead.

Pick your client. Each tab has three parts: add the connector, sign in, check it worked. When you sign in, sign in or create a Sumvin account. You can connect before you have an account; your agent helps you finish creating one.

<Tabs>
  <Tab title="Claude">
    Works on claude.ai and in Claude Desktop. Add it once on claude.ai.

    <Steps>
      <Step title="Add the connector">
        Go to **Customize > Connectors**, select **Add custom connector**, and enter:

        ```text theme={null}
        https://mcp.sumvin.com/mcp
        ```

        Name it `Sumvin` and select **Add**. Leave the other settings as they are.
      </Step>

      <Step title="Sign in">
        Select **Connect** and sign in or create a Sumvin account in the window that opens.
      </Step>

      <Step title="Check it worked">
        Sumvin shows as connected under **Customize > Connectors**. In a chat, open the **+** menu, then **Connectors**, and make sure Sumvin is on.
      </Step>
    </Steps>

    On a Team or Enterprise plan, an Owner adds the connector under **Organization settings > Connectors** (**Add**, then **Custom**, then **Web**). Each member then finds it under **Customize > Connectors** and selects **Connect**.
  </Tab>

  <Tab title="ChatGPT">
    Needs developer mode, on ChatGPT on the web. Custom apps aren't available in the ChatGPT mobile app.

    <Note>
      Custom connectors may be limited on Plus and Pro. Full use needs a Business, Enterprise or Edu plan with developer mode turned on.
    </Note>

    <Steps>
      <Step title="Turn on developer mode">
        Go to **Settings > Apps > Advanced settings** and turn on **Developer mode**. On a workspace plan, an admin may need to allow it first; see below.
      </Step>

      <Step title="Add the connector">
        In **Settings > Apps**, select **Create** and enter:

        ```text theme={null}
        https://mcp.sumvin.com/mcp
        ```

        Name it `Sumvin` and choose **OAuth** for authentication. Select **Scan Tools**, then **Create**.
      </Step>

      <Step title="Sign in">
        Sign in or create a Sumvin account when ChatGPT asks.
      </Step>

      <Step title="Check it worked">
        Sumvin appears under **Settings > Apps**, labelled **Dev**. In a new chat, select Sumvin from the tools menu.
      </Step>
    </Steps>

    <Note>
      ChatGPT may ask you to confirm a Sumvin tool call before it runs.
    </Note>

    On a ChatGPT Business, Enterprise or Edu workspace, admins control custom apps:

    * An admin allows developer mode under **Workspace settings > Permissions & roles > Connected Data**. On Business, only admins and owners can use developer mode.
    * An admin can also add Sumvin from **Workspace settings > Apps > Create**, then publish it from **Workspace settings > Apps > Drafts**.
    * Once it's published, members find Sumvin under **Settings > Apps**, marked **custom**, and each member signs in with their own Sumvin account.

    On Business, a published app can't be updated. If Sumvin adds tools, an admin recreates and republishes the app.
  </Tab>

  <Tab title="ChatGPT Work">
    ChatGPT Work is the mode in ChatGPT for longer tasks. In the ChatGPT desktop app, on any plan, you add Sumvin as an MCP server.

    <Steps>
      <Step title="Add the connector">
        In the ChatGPT desktop app, open **Settings**, then **MCP servers**, and select **Add server**. Name it `sumvin`, choose **Streamable HTTP**, and enter:

        ```text theme={null}
        https://mcp.sumvin.com/mcp
        ```

        Save the server, then select **Restart**.
      </Step>

      <Step title="Sign in">
        In the server list, select **Authenticate** next to Sumvin. Sign in or create a Sumvin account in your browser.
      </Step>

      <Step title="Check it worked">
        In the composer, type `/mcp`. Sumvin is listed.
      </Step>
    </Steps>

    For now, Sumvin works in ChatGPT Work in the ChatGPT desktop app. Keep **Work locally** selected in the composer.
  </Tab>

  <Tab title="Claude Code">
    <Steps>
      <Step title="Add the connector">
        ```bash theme={null}
        claude mcp add --transport http --scope user sumvin https://mcp.sumvin.com/mcp
        ```

        `--scope user` makes Sumvin available in every project. Your Sumvin identity belongs to you, not to one repository.
      </Step>

      <Step title="Sign in">
        ```bash theme={null}
        claude mcp login sumvin
        ```

        Or run `/mcp` inside Claude Code and choose Sumvin. Sign in or create a Sumvin account in your browser.
      </Step>

      <Step title="Check it worked">
        `/mcp` lists `sumvin` as connected.
      </Step>
    </Steps>

    If you added Sumvin on claude.ai and sign in to Claude Code with the same Claude account, it may already be there.
  </Tab>

  <Tab title="OpenClaw">
    <Steps>
      <Step title="Add the connector">
        ```bash theme={null}
        openclaw mcp add sumvin --url https://mcp.sumvin.com/mcp --transport streamable-http --auth oauth
        ```
      </Step>

      <Step title="Sign in">
        ```bash theme={null}
        openclaw mcp login sumvin
        ```

        Follow the link it prints, and sign in or create a Sumvin account. If your browser can't reach the machine running OpenClaw, use the `--code` command it prints instead.
      </Step>

      <Step title="Check it worked">
        ```bash theme={null}
        openclaw mcp probe sumvin
        ```

        The probe connects and lists Sumvin's tools.
      </Step>
    </Steps>

    <Warning>
      By default, OpenClaw uses one shared sign-in for each server. Anyone who can talk to your OpenClaw acts on Sumvin as you. If other people use your OpenClaw, set up per-requester sign-in first; see OpenClaw's [Transports and OAuth](https://docs.openclaw.ai/cli/mcp/transports).
    </Warning>

    <Info>
      **What they still can't do: approve.** Anything that needs your authority still needs a [Stamped Mandate](/concepts/stamped-mandates) that you approve yourself, with your passkey, on a Sumvin page in your own browser. Someone messaging your OpenClaw can ask for a mandate, but they can't approve one without your passkey. That is a real step up for OpenClaw: it can act for you, while the authority stays with you.
    </Info>
  </Tab>

  <Tab title="Hermes Agent">
    <Steps>
      <Step title="Add the connector">
        ```bash theme={null}
        hermes mcp add --url https://mcp.sumvin.com/mcp --auth oauth sumvin
        ```
      </Step>

      <Step title="Sign in">
        Hermes opens your browser the first time it connects. Sign in or create a Sumvin account. To sign in again later, run `hermes mcp login sumvin`.
      </Step>

      <Step title="Check it worked">
        ```bash theme={null}
        hermes mcp test sumvin
        ```

        Then start a new `hermes chat`, or run `/reload-mcp` in one that's already open, so Sumvin's tools load.
      </Step>
    </Steps>

    Sign-in finishes on the machine where Hermes runs. If Hermes runs on a remote host, see Hermes Agent's [OAuth over SSH](https://hermes-agent.nousresearch.com/docs/guides/oauth-over-ssh).
  </Tab>
</Tabs>

## Troubleshooting

<AccordionGroup>
  <Accordion title="The connector won't connect">
    Check the address is exactly `https://mcp.sumvin.com/mcp`, including `/mcp` at the end. Remove the connector and add it again. Restart your client.
  </Accordion>

  <Accordion title="Sign-in failed">
    Remove the connector and add it again, then finish sign-in in the browser window your client opens. Claude Code users can run `claude mcp login sumvin` again.
  </Accordion>

  <Accordion title="I don't see Sumvin's tools">
    Make sure Sumvin is switched on for this conversation: the **Connectors** item in Claude's **+** menu, or Sumvin in ChatGPT's tools menu. In Hermes Agent, run `/reload-mcp`. If you don't have a Sumvin account yet, your agent sees one tool, which gives you a sign-up link. See [Your first conversation](/get-started/first-conversation).
  </Accordion>

  <Accordion title="How do I disconnect?">
    * **Claude**: **Customize > Connectors**, then **Remove** on Sumvin.
    * **Claude Code**: `claude mcp remove sumvin`. This also deletes the sign-in Claude Code stored.
    * **ChatGPT**: manage the app under **Settings > Apps**.
    * **ChatGPT Work** (desktop app): manage Sumvin under **Settings > MCP servers**.
    * **OpenClaw**: `openclaw mcp logout sumvin`, then `openclaw mcp unset sumvin`.
    * **Hermes Agent**: `hermes mcp remove sumvin`.

    Disconnecting a client stops it reaching Sumvin. To withdraw what an agent was allowed to do, see [Revoke access](/guides/revoke).
  </Accordion>
</AccordionGroup>

<Tip>**Try asking your agent:** "What can you do with Sumvin?"</Tip>