Developer docs

Connect a server to claude.ai

Updated 20 Oct 2026 · Clients

On this page
  1. Before you start
  2. Connect it
  3. What Claude can do
  4. Disconnect
  5. Limits
  6. Troubleshooting

The short version

  • Paste your server's URL into claude.ai as a custom connector, sign in with your Saywire account and click Allow.
  • Claude then calls that server's enabled tools as you. Write tools only run if you turned them on.
  • One connection works with one server only. Disconnect it from the server's Connect tab; it stops at once.
  • No API key to copy: claude.ai can't send one, so it signs in instead. Claude Code, Cursor and other config-file clients keep using API keys.

1Before you start

  • A deployed Saywire server. Its URL is on the server's Connect tab and looks like https://mcp.saywire.dev/your-username/my-server/mcp.
  • A Claude plan that supports custom connectors. On Team and Enterprise plans, an owner may need to allow custom connectors for the organization first.
  • Access to the server in Saywire: your own server, or a server in a team workspace you're a member of.

2Connect it

  1. In the Saywire dashboard, open the server and go to the Connect tab. Copy the server URL.
  2. In claude.ai, open Settings → Connectors and click Add custom connector.
  3. Paste the URL. Under Authentication keep Sign in now; under OAuth client choose Register automatically (the default, "Use Claude's published identity", doesn't work with Saywire yet). Click Add.
  4. A Saywire page opens: sign in if asked.
  5. The page names the server from the URL you pasted. Check it's the right one and what the app is asking for, then click Allow.
  6. You're sent back to Claude. The server's enabled tools now show up in the connector, and you can turn them on in a chat.

The connection belongs to you and to that server. The app shows up under Connected apps on that server's Connect tab, with when it was connected and last used. In a team workspace, admins see the apps everyone connected; other members see their own.

3What Claude can do

  • Claude can call the server's enabled tools, as you. It sees nothing else in your Saywire account: no other servers, settings, keys or secrets.
  • Write tools are off by default. Turn on only the ones you want Claude to call, on the server's Tools tab.
  • Check what it called on the server's Logs tab. Calls from Claude count toward your plan's monthly calls, like calls with an API key.
  • If Claude lets you choose whether it asks before using a tool, keep asking on for write tools.

4Disconnect

  • On the server's Connect tab, find the app under Connected apps and click Disconnect. Its next call is refused straight away.
  • You can also remove the connector in claude.ai under Settings → Connectors.
  • To use it again, click Connect on the connector in Claude and allow it again.

5Limits

The number of apps connected to one server depends on your Saywire plan:

PlanConnected apps per server
Free2
Pro10
Team25
DedicatedNo limit

6Troubleshooting

  • "This connection request expired": the sign-in took too long or was already used. Start again from Claude: click Connect on the connector.
  • Connected-app limit reached: disconnect an app you no longer use from the server's Connect tab, or upgrade your plan.
  • It now talks to a different server: a connection works with one server. Allowing the same connector for another server moves it there and ends its access to the first.
  • No tools show up: check the server is deployed and has enabled tools, then reconnect the connector in Claude.
  • Calls fail after it worked: someone may have disconnected the app, or you lost access to the server or its team. Connect it again.