Connect your MCP client
Add the Spradley MCP server to Claude, ChatGPT, Microsoft 365 Copilot, Claude Code or Codex and sign in with Spradley.
For every client below: after adding the server, click Connect, sign in to Spradley when asked, read what the app will and will not see, click Allow, and start asking.
Your company's owner has to turn the connector on first, in Spradley under Settings → Integrations. The same page shows the server URL with a copy button.
Claude
In Claude, go to Settings → Connectors → Add custom connector, name it Spradley and paste the server URL:
https://app.spradley.io/api/mcpClick Add, then Connect, sign in to Spradley and allow access.
ChatGPT
In ChatGPT, go to Settings → Connectors → Create, paste the server URL and choose OAuth as the authentication:
https://app.spradley.io/api/mcpSign in to Spradley and allow access.
Microsoft 365 Copilot
Add Spradley as an MCP server to a declarative agent and point it at the server URL. Your Microsoft 365 admin may need to approve the agent before your team can use it.
Claude Code
Open your terminal
Open the terminal where you run Claude Code.
Add the server
claude mcp add --transport http spradley https://app.spradley.io/api/mcpAuthenticate
Run
/mcpin Claude Code, choose spradley, sign in and allow access.
Codex
Open your terminal
Open the terminal where you run Codex.
Add the server
codex mcp add spradley --url https://app.spradley.io/api/mcpAuthenticate
Codex opens your browser. Sign in, allow access, and use.
Other clients
Spradley only sends its sign-in back to claude.ai, chatgpt.com, Microsoft Teams and apps running on your own computer. An app that asks to return anywhere else is refused at the consent step, whatever name it gives itself.
Server URL
https://app.spradley.io/api/mcpThe server uses stateless Streamable HTTP: each request stands on its own, and there are no long-lived sessions to manage.
First-time authentication
Discovery
Your client finds Spradley's sign-in details from the server URL on its own.
Sign in
Your browser opens Spradley. If you are not signed in, you sign in first and come back.
Consent
Spradley shows the app's name, where it will send you back, and what it can and cannot read.
Allow
You click Allow. The connection is tied to you and to your company at that moment.
Permissions
Allowing access lets the app, acting as you:
- List the completed reports you can see
- Read their themes, the reasons under them and their published quotes
- Compare a theme across departments of five people or more
- Ask Spradley a question about them
It cannot change anything in Spradley. The app sees what your role sees, and no more. Something not working? See troubleshooting.