Connect ChatGPT

Updated 2026-11-13

This page shows how to connect ChatGPT to your SpreadAPI account, and how to give ChatGPT access to just one service, public or protected.

Connect ChatGPT to your account

ChatGPT 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 ChatGPT.
  3. Copy the address (Adresse kopieren). It is https://spreadapi.io/mcp.
  4. Add it in ChatGPT (In ChatGPT eintragen): add a custom MCP server, paste the address and choose OAuth as authentication.
  5. Allow access (Zugriff erlauben). ChatGPT opens SpreadAPI in your browser. Sign in to SpreadAPI if you are asked to, then confirm what ChatGPT may do.
  6. Back in SpreadAPI, click Done (Fertig). The connection named "ChatGPT" appears in the list on the AI agents page.

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

The page where you allow access

The page is titled Connect ChatGPT to SpreadAPI. It shows which application asks and for which account (your e-mail address), what ChatGPT may then do, and a summary line such as "Full access · all 4 services, including new ones".

  • Click Change (Ändern) to pick a level (Use, Edit, Full access) and to limit the connection to chosen services.
  • Click Allow ChatGPT (ChatGPT erlauben) to create the connection, or Cancel (Abbrechen) to share nothing.

You can change or revoke the access at any time under AI agents. See The AI agents page and Rights and limits of a connection.

Connect ChatGPT to one service only

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

  1. Open the service and 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 ChatGPT as a custom MCP server.

What happens next depends on the service:

  • Public service: no sign-in is asked for. ChatGPT can calculate right away.
  • Protected service: ChatGPT asks for a sign-in and opens the page Connect to SpreadAPI Service. The person pastes a service token that you created under API → Access (API → Zugriff) and clicks Authorize. The sign-in lasts 12 hours; after that ChatGPT asks again.

Create one token per person or customer, so that you can revoke one without affecting the others. See Tokens and access.

What ChatGPT can do afterwards

  • With an account connection: list your services, calculate with them and, if you allowed it, create, change, test and publish services. See What a connected agent can do.
  • With a service address: calculate with this one service (spreadapi_calc), compare scenarios (spreadapi_batch) and read the service's inputs and outputs (spreadapi_get_details). It cannot see or change anything else.

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 ChatGPT and confirm within a few minutes.
  • The service address does not answer: the service is a draft. Publish it first.
  • More cases: AI troubleshooting.

For developers and agents

  • Account address: https://spreadapi.io/mcp; authentication OAuth 2 with PKCE, started by the HTTP 401 answer of a call that needs a connection.
  • The account connection made by the sign-in is named "ChatGPT". There is one per account; signing in again reuses it and applies the newly confirmed level and services.
  • Service address: https://spreadapi.io/api/mcp/service/<service_id>. A protected service answers HTTP 401 "Authentication required" until the client signs in or sends a service token as Authorization: Bearer <token>.
  • A sign-in at a service address is valid for that one service only.

FAQ

How do I connect ChatGPT to SpreadAPI?

Add a custom MCP server in ChatGPT with the address https://spreadapi.io/mcp and choose OAuth as authentication. ChatGPT then opens SpreadAPI in your browser, where you confirm what it may do.

Which authentication do I choose in ChatGPT?

Choose OAuth for the account address https://spreadapi.io/mcp. For the MCP address of a public service no authentication is needed.

How does a customer use my protected service in ChatGPT?

Give them the service's MCP address and a service token from API → Access. ChatGPT asks for a sign-in, they paste the token on the page Connect to SpreadAPI Service and click Authorize.

Why does ChatGPT ask for the token again?

The sign-in at a protected service address lasts 12 hours. After that ChatGPT asks for a new sign-in, and the person pastes the token again.

Can I limit ChatGPT to some of my services?

Yes. On the page where you allow access click Change (Ändern) and choose Only these (Nur diese), or change it later under AI agents → Manage. A service that is not chosen does not exist for the connection.

How do I remove ChatGPT's access?

Open AI agents, click Manage (Verwalten) on the ChatGPT connection and then Revoke access (Zugriff widerrufen). For a customer who uses a service token, revoke that token under API → Access.

Does my customer need a SpreadAPI account to use my service in ChatGPT?

No. A customer needs only the service's MCP address, and for a protected service a token you created. An account is needed only for an account connection.

Can ChatGPT build a service from my spreadsheet?

Yes, with an account connection on the level Edit or Full access. See Build a service with an agent.