Before you start
- Claude Code installed and signed in.
- For OAuth: the owner or an integration admin role in your Quotable workspace, to approve the connection.
- For an API key: a key from Settings → API keys. See Authentication for the scopes each tool needs.
Add the server
- Sign in with OAuth
- API key, just for you
- API key, for your team (.mcp.json)
Add the server without a header:Then start Claude Code, type
/mcp, select quotable and choose Authenticate. Your browser opens a Quotable page: sign in if asked, check that it sends you back to localhost, pick the workspace, the data and the brands, and click Allow access. Claude Code stores the tokens and renews them on its own.Leave out --scope user to add the server to the current project only. The same setup works in a shared .mcp.json without a headers block; each teammate then signs in with their own Quotable account.Check the connection
Runclaude mcp get quotable from your terminal, or type /mcp inside Claude Code. The server should show as connected with its tools, such as list_projects, get_visibility and list_citations. See Tools for the full list.
If it shows Needs authentication, choose Authenticate in /mcp to sign in. If you added the server with a key and still see it, the Authorization header isn’t reaching the server: check that the variable was set when you ran claude mcp add, or that it’s set in the shell that started Claude Code. See Troubleshooting.
Try it
run_agent, which starts an agent run and uses your workspace’s credits. Approve it only for runs you asked for.
Update or remove
To sign out of an OAuth connection, open/mcp, select quotable and clear its authentication, or click Disconnect under Connected apps in Quotable. To rotate a key, remove the server and add it again with the new key:
--scope, remove deletes the server from whichever scope it was added to. With .mcp.json, change the environment variable and restart Claude Code instead.
Next steps
Example prompts
Ready-to-use questions for your workspace.
Workflows
Combine Quotable with your other tools.
Tools reference
Inputs and outputs for each tool.