Connect ChatGPT, Claude and other apps

Some apps cannot take a personal access token: ChatGPT’s and claude.ai’s connector dialogs only know how to sign you in. Mapsurvey supports that flow. The app sends you to a Mapsurvey page, you check what it asks for and press Allow, and the app gets its own keys — limited to the permissions you allowed, revocable from your account at any time.

The API is a Pro feature. You can connect an app on any plan; calls on a survey answer pro_required until that survey’s workspace is on Pro.

What the Allow page shows

• The host first. The address the app will send you back to (for example claude.ai) is the one thing an app cannot fake. The name under it is whatever the app calls itself — read the host.
• What it may do. Reading surveys, creating and editing them, reading responses are granted with Allow. Publishing and deleting are switches, off unless you turn them on: those calls cannot be undone. Approving, holding or rejecting responses is a switch too: it can be changed back, but rejected responses leave exports and public results.
• Where. Every workspace you belong to, in a folded table with the Pro workspaces first.

Press Cancel to send the app away with nothing. Once you allowed an app, it will not ask again unless it wants more than you granted.

Set up your assistant

Each assistant has its own way to add Mapsurvey; Use the MCP server has the steps for each one — Claude, ChatGPT, Gemini, Le Chat, Perplexity, Cursor, VS Code, Claude Code, Codex and more. In the product, MCP in the sidebar gives the same steps with one button where the assistant allows it.

Desktop tools (Claude Code, Codex, Cursor, VS Code) listen on a local port for the answer, which is why the host on the Allow page reads localhost (this computer) for them.

Any other OAuth app

Point it at https://mapsurvey.org/.well-known/oauth-authorization-server. The server supports dynamic client registration, PKCE (S256), refresh tokens and https redirect addresses (plus loopback http://127.0.0.1 and http://localhost for desktop tools). There is nothing to configure on the Mapsurvey side.

See what is connected, disconnect

Open API & connections from your account menu. Connected apps lists every app you allowed with its host, permissions, when you connected it and when it last called. Disconnect ends its access at once; the app will have to ask again.

Trouble?

• “This app cannot connect” with an error code — the app sent a request Mapsurvey refuses (an address it did not register, a missing PKCE challenge). Tell the app’s maker the code.
• The app connected but every call fails with pro_required — the survey’s workspace is on Free. See Plans and billing.
• You expected to be asked and were not — you allowed this app before with the same permissions. Disconnect it to be asked again.