Connect Claude

Updated 2026-11-13

This page shows how to connect Claude to your SpreadAPI account, how to connect Claude Code, and how to give Claude access to just one service.

Connect Claude to your account

Claude signs in to SpreadAPI; you do not need a key.

  1. In SpreadAPI, open the AI agents (KI-Agenten) page from the service list and click Connect an AI (KI verbinden).
  2. Under With sign-in · no key (Mit Anmeldung · ohne Schlüssel) choose Claude.
  3. Copy the address (Adresse kopieren). It is https://spreadapi.io/mcp.
  4. Add it in Claude (In Claude eintragen). The dialog says: Settings → Connectors → Add → Custom connector: give it a name and paste the address. On the next step choose "Sign in when needed". If your version of Claude words this differently, add a custom connector (an MCP server) in your AI client and enter this address.
  5. Allow access (Zugriff erlauben). Claude opens SpreadAPI in your browser. Sign in to SpreadAPI if you are asked to, then confirm what Claude may do (see below).
  6. Back in SpreadAPI, click Done (Fertig). The connection named "Claude" appears in the list on the AI agents page.

To try it, ask Claude: "Which services do I have at SpreadAPI?"

The page where you allow access

The page is titled Connect Claude to SpreadAPI (Claude mit SpreadAPI verbinden). It shows:

  • which application asks, and for which account (your e-mail address), so that you do not connect the wrong account;
  • what Claude may then do, as three lines: see services and calculate with them, create and change services, publish services;
  • a summary line with the level and the services, for example "Full access · all 4 services, including new ones".

Click Change (Ändern) to choose a level (Use, Edit or Full access) and to limit the connection to chosen services. See Rights and limits of a connection.

Click Allow Claude (Claude erlauben) to create the connection, or Cancel (Abbrechen) to share nothing. You can change or revoke the access at any time under AI agents.

If Claude is already connected, the page says so, and what you confirm replaces the earlier choice.

Connect Claude Code

  1. On the AI agents page click Connect an AI and choose Claude Code.
  2. Run this in your terminal (Im Terminal ausführen):
claude mcp add --transport http spreadapi https://spreadapi.io/mcp
  1. In Claude Code type /mcp, pick spreadapi and "Authenticate".
  2. Claude Code opens SpreadAPI in your browser. Confirm what it may do. The connection appears as "Claude Code".

Connect Claude to one service only

Use this when Claude belongs to someone else, for example a customer, and should reach exactly one calculation.

  1. Open the service, select AI → Connect (KI → Verbinden).
  2. Copy the address under Someone else's AI: the MCP address of this service. It has the form https://spreadapi.io/api/mcp/service/<service_id>.
  3. The other person adds this address to Claude as a custom connector.

For a public service no sign-in is asked for. For a service that is protected by a token, use an account connection for Claude instead; the sign-in of a protected service address is built for ChatGPT. See The MCP address of one service.

What Claude can do afterwards

With an account connection Claude can list your services, calculate with them and, if you allowed it, create, change, test and publish services. See What a connected agent can do and Build a service with an agent.

If it does not work

  • "AI access is switched off for this account": switch AI access to this account on under AI agents, then start the connection again.
  • "This request has expired": start the connection again in Claude and confirm within a few minutes.
  • "This account already has the most connections (25)": revoke one under AI agents first.
  • More cases: AI troubleshooting.

For developers and agents

  • Account address: https://spreadapi.io/mcp (MCP, streamable HTTP).
  • A call that needs a connection answers HTTP 401 with a WWW-Authenticate header that points the client to the sign-in. The sign-in is OAuth 2 with PKCE; the client needs no client secret.
  • The connection made by the sign-in is named after the client ("Claude" or "Claude Code"). There is one connection per client and account; signing in again reuses it and applies the newly confirmed level and services.
  • The default on the consent page is Full access for all services, including new ones; a returning client starts with its current level and services.
  • Revoking the connection on the AI agents page ends every sign-in made through it at once.

FAQ

How do I connect Claude to SpreadAPI?

Add a custom connector in Claude with the address https://spreadapi.io/mcp. Claude then opens SpreadAPI in your browser, where you confirm what it may do.

Do I need a key or token to connect Claude?

No. Claude signs in through your browser, and the connection itself is the access. Services that are protected by a token can be called through the connection without a token.

How do I connect Claude Code?

Run claude mcp add --transport http spreadapi https://spreadapi.io/mcp in your terminal. Then type /mcp in Claude Code, pick spreadapi and "Authenticate", and confirm in the browser.

Can I limit what Claude may do in my account?

Yes. On the page where you allow access, click Change (Ändern) and choose Use, Edit or Full access and the services it reaches. You can change this later under AI agents → Manage.

Can I connect Claude to just one service?

Yes. Either limit the account connection to that service, or give the service's MCP address from AI → Connect to the person whose Claude it is. The service address works without sign-in for a public service.

Claude is connected. How do I disconnect it?

Open AI agents, click Manage (Verwalten) on the Claude connection and then Revoke access (Zugriff widerrufen). Claude loses access at once; services it created stay.

I signed in from Claude a second time. Do I now have two connections?

No. There is one connection per client; the second sign-in reuses it, and the level and services you confirmed replace the earlier choice.

Which account does Claude get access to?

The account you are signed in to in the browser when you confirm. The page shows the account's e-mail address before you click Allow Claude.

Does Claude on the web and in the desktop app use the same address?

Yes. The address is https://spreadapi.io/mcp in every case; only Claude Code is added with a terminal command instead of the connector settings.