# Connect with MCP Connect your assistant to Citation. Find documents, read sources, edit drafts and format references with permissions you control. ## Connect your workspace Add the server address to your client, sign in to Citation, and review its requested permissions. Read access is the starting point. Approve writing or exporting only when you need it. MCP server address ``` https://citation.co/mcp ``` Use the exact server address shown in MCP connections. If you host Citation yourself, configure its MCP address and database migration before connecting. Clients without OAuth can use a scoped bearer token from MCP connections. Send it in the Authorization header and keep it out of shared configuration files. ## ChatGPT MCP connection. Bring your Citation workspace into a ChatGPT conversation. Custom MCP access must be available in your account. Workspace policies may require an administrator. 1. Open Plugins and choose Add custom MCP server. 2. Paste the Citation server address and choose OAuth authentication. 3. Sign in to Citation, choose a workspace, and approve the permissions you need. MCP server address ``` https://citation.co/mcp ``` - [Official ChatGPT guide](https://developers.openai.com/api/docs/guides/custom-mcp-server) - [Download ChatGPT plugin](/downloads/ai/citation-openai-plugin-0.1.0.zip) - [ChatGPT skills setup](/docs/skills#chatgpt) ## Claude MCP connection. Search saved research and work on drafts from Claude. Use an account with custom connector access. Organization policies and account connection limits still apply. 1. Open Settings, then Connectors, and add a custom connector. 2. Enter Citation and the server address. Choose automatic OAuth registration when prompted. 3. Connect, sign in to Citation, and approve access to your workspace. MCP server address ``` https://citation.co/mcp ``` - [Official Claude guide](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) - [Download Claude plugin](/downloads/ai/citation-claude-plugin-0.1.0.zip) - [Claude skills setup](/docs/skills#claude) ## Gemini MCP connection. Connect saved documents through Gemini custom apps. Custom apps require an eligible personal account in the US, age 18 or older, English, and Keep Activity enabled. Availability varies by rollout. 1. On Gemini web, open Settings, then Connected Apps and custom apps. 2. Add the Citation server address and use automatic OAuth registration. 3. Sign in to Citation and approve workspace access. Enable the connected app in your conversation. MCP server address ``` https://citation.co/mcp ``` - [Official Gemini guide](https://support.google.com/gemini/answer/17209137?hl=en-yt) - [Gemini skills setup](/docs/skills#gemini) ## Perplexity MCP connection. Use your saved research with a remote connector. Custom remote connectors require an eligible Pro, Max, or Enterprise account. Skills are used in Computer. 1. Open Account Settings, then Connectors, and choose Custom connector. 2. Choose Remote, enter the Citation server address, and select OAuth. 3. Complete automatic registration and sign in to Citation to choose your workspace. MCP server address ``` https://citation.co/mcp ``` - [Official Perplexity guide](https://www.perplexity.ai/help-center/en/articles/13915507-adding-custom-remote-connectors) - [Perplexity skills setup](/docs/skills#perplexity) ## Grok MCP connection. Add Citation as a custom connector in Grok. The custom connector control must be available in your Grok account. 1. Open Grok Connectors and choose New Connector, then Custom. 2. Enter the Citation server address and select the supported authentication option. 3. Use OAuth when offered, or a scoped Citation token in the private authentication field. MCP server address ``` https://citation.co/mcp ``` - [Official Grok guide](https://docs.x.ai/grok/connectors) ## Manus MCP connection. Give a Manus workflow access to your saved Citation work. Use a scoped personal token in the private bearer authentication field. Keep it out of prompts and shared files. 1. Create a personal token for the required workspace and permissions in Citation MCP connections. 2. In Manus, open Settings, Integrations, then Custom MCP. 3. Enter the server address and provide the token using bearer authentication. MCP server address ``` https://citation.co/mcp ``` - [Official Manus guide](https://manus.im/docs/integrations/custom-mcp) ## Genspark MCP connection. Connect Citation tools to a Genspark workflow. Custom connectors depend on account availability and organization policies. 1. In Genspark, open Skills, Connectors, Community & Custom, then Add new MCP server. 2. Enter Citation as the name, choose Streamable HTTP, and enter the Citation server address. Leave Request Header JSON empty, then choose Add Server. 3. Complete the Citation OAuth sign in, select your workspace, review the requested permissions, then allow access. MCP server address ``` https://citation.co/mcp ``` - [Official Genspark guide](https://www.genspark.ai/helpcenter/connectors-and-integrations) ## Mistral Vibe MCP connection. Use Citation in Vibe Work, formerly Le Chat. A Vibe administrator adds the connector. Personal account owners are administrators. This setup is for Vibe Work. 1. In Vibe Work, open Connectors, choose Add Connector, then Custom MCP Connector. 2. Enter Citation as the name and the Citation server address, then choose Connect. Vibe detects authentication automatically. 3. Complete the Citation sign in and consent flow, then enable the connector for your conversation. MCP server address ``` https://citation.co/mcp ``` - [Official Mistral Vibe guide](https://docs.mistral.ai/vibe/work/connectors/mcp-connectors) ## Kimi Personal plugin. Install a personal plugin with Citation tools and four skills. Build the personal plugin in Kimi Work. Web supports its MCP tools and skills in eligible scenarios. Kimi Claw and Kimi Plus conversations do not support this route. 1. Download and extract the Kimi plugin package. 2. Open Plugin Builder in Kimi Work and import the extracted plugin files. 3. Add the plugin to your Personal marketplace, install it, and authenticate its Citation MCP connection. MCP server address ``` https://citation.co/mcp ``` - [Official Kimi guide](https://www.kimi.com/en/help/plugins-and-skills/create) - [Download Kimi plugin](/downloads/ai/citation-kimi-plugin-0.1.0.zip) - [Kimi skills setup](/docs/skills#kimi) ## Muse Directory connector. A Citation connector for the Muse directory. The Citation connector requires provider review and publication before it can be installed. It is not listed yet. 1. A publisher submits the Citation connector for Muse review. 2. After publication, find Citation in the Muse connector directory. 3. Connect your Citation account and approve workspace permissions. - [Official Muse guide](https://muse.ai/platform) ## Microsoft 365 Copilot MCP connection. Find Citation research with a federated connector. Requires a Microsoft 365 administrator, registered OAuth credentials, and tenant deployment. This connector provides reading tools. Consumer Copilot uses a different integration system. 1. Ask your Microsoft 365 administrator to configure the Citation federated connector. 2. Register the connector OAuth client and credentials, then add its endpoint and manifest in your tenant. 3. After administrator approval, authenticate Citation to search and read your saved research. MCP server address ``` https://citation.co/mcp/read ``` The administrator registers a confidential OAuth client with an ID and secret. Use https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect as the exact redirect URI and enable PKCE S256. The federated endpoint exposes search and fetch with document and source read permissions. Keep credentials in the administrator’s private connector configuration. - [Official Microsoft 365 Copilot guide](https://learn.microsoft.com/en-us/microsoft-365/copilot/connectors/set-up-custom-federated-connectors) ## Poe Assistant bot. Search your saved research and work on drafts in Poe. Connect your Citation account to access saved work. Writes and exports require your approval. 1. Open Citation in Poe and send connect. 2. Open the private Citation link, choose your workspace and permissions, then return the confirmation code to the same Poe conversation. 3. Ask the bot to work with your saved research. Review and approve proposed writes or exports before they run. - [Open Citation in Poe](https://poe.com/Citation.co) - [Official Poe guide](https://creator.poe.com/docs/server-bots/poe-protocol-specification) ## Yuanbao Assistant bot. A Yuanqi agent using Citation MCP or API tools. The Citation agent is not available yet. Citation compatibility, private credentials for each user, and Yuanbao access must be verified before sharing. 1. In Yuanqi, add a custom MCP plugin by URL or JSON, or configure an API plugin. 2. Validate Citation tools and each user's private account connection in a private agent. Never share personal tokens in chat. 3. Check the creator's Yuanbao My area, then Agents, or the mini program QR entry. Creator agents are not currently listed in the public app square and may not be searchable. - [Official Yuanbao guide](https://yuanqi.tencent.com/guide/plugin-market-integrate-mcp-plugin) ## DeepSeek Model in Citation. Use a DeepSeek model while working inside Citation. Requires the provider to be enabled on this Citation deployment. This does not connect the DeepSeek consumer app to your workspace. 1. Open the assistant in your Citation workspace. 2. Choose DeepSeek from the available model providers. 3. Work with the document in Citation. If the provider is unavailable, ask your deployment administrator to configure it. The model is used for writing chat and draft generation inside Citation. Cite, Check, and voice keep their own providers. No personal provider API key is required. Models appear only when enabled on the Citation deployment. - [Official DeepSeek guide](https://api-docs.deepseek.com/) ## Qwen Model in Citation. Qwen model access inside the Citation assistant. Qwen is awaiting availability in Citation. It appears only after the provider is enabled. This does not add a connector to the Qwen consumer app. 1. Open the assistant in your Citation workspace. 2. Choose Qwen from the available model providers. 3. Continue with your document in Citation. Provider availability depends on deployment configuration. The model is used for writing chat and draft generation inside Citation. Cite, Check, and voice keep their own providers. No personal provider API key is required. Models appear only when enabled on the Citation deployment. - [Official Qwen guide](https://www.alibabacloud.com/help/en/model-studio/developer-reference/use-qwen-by-calling-api) ## Doubao Model in Citation. ByteDance Seed model access inside Citation. ByteDance Seed is awaiting availability in Citation. It appears only after the provider is enabled. This route is separate from the Doubao consumer app. 1. Open the assistant in your Citation workspace. 2. Choose ByteDance Seed from the available model providers. 3. Work with your saved document in Citation. Provider availability depends on deployment configuration. The model is used for writing chat and draft generation inside Citation. Cite, Check, and voice keep their own providers. No personal provider API key is required. Models appear only when enabled on the Citation deployment. - [Official Doubao guide](https://docs.byteplus.com/en/docs/ModelArk) ## Codex MCP connection. Connect your coding agent to Citation research tools. Run the setup on the host where Codex is installed. Cloud tasks need their own supported connection configuration. 1. Run the setup commands in a terminal on your Codex host. 2. Complete the Citation OAuth flow and select your workspace. 3. Enable Citation in the agent and install the research skills when needed. Codex configuration ``` codex mcp add citation --url https://citation.co/mcp codex mcp login citation ``` - [Official Codex guide](https://learn.chatgpt.com/docs/extend/mcp?surface=cli) - [Download Codex plugin](/downloads/ai/citation-openai-plugin-0.1.0.zip) - [Codex skills setup](/docs/skills#codex) ## Claude Code MCP connection. Use Citation from Claude Code and its project skills. Run the setup in your project and approve Citation in the browser. Organization policies may restrict external tools. 1. Run the setup commands in your project. 2. Complete Citation OAuth login and select the required workspace. 3. Use the MCP tools directly or install the Citation skills in your project. Claude Code configuration ``` claude mcp add --transport http citation https://citation.co/mcp claude mcp login citation ``` - [Official Claude Code guide](https://code.claude.com/docs/en/mcp) - [Download Claude Code plugin](/downloads/ai/citation-claude-plugin-0.1.0.zip) - [Claude Code skills setup](/docs/skills#claude-code) ## Cursor MCP connection. Keep research available to Cursor Agent. Merge the configuration into .cursor/mcp.json without replacing your other servers. 1. Add the configuration to .cursor/mcp.json in your project. 2. Open Cursor MCP settings and authenticate Citation. 3. Approve access to your workspace and enable the tools for Agent. Cursor configuration ``` { "mcpServers": { "citation": { "url": "https://citation.co/mcp" } } } ``` - [Official Cursor guide](https://cursor.com/docs/mcp) ## GitHub Copilot MCP connection. Add Citation tools to Copilot Chat in VS Code. Use a compatible VS Code installation. Your organization can restrict MCP servers. 1. Merge the configuration into .vscode/mcp.json in your project. 2. Start the Citation server from VS Code MCP settings and complete OAuth. 3. Select the Citation tools in Copilot Chat when working with research. GitHub Copilot configuration ``` { "servers": { "citation": { "type": "http", "url": "https://citation.co/mcp" } } } ``` - [Official GitHub Copilot guide](https://code.visualstudio.com/docs/agents/reference/mcp-configuration) ## Choose your client Choose your client below for its configuration and setup guide. Use the instructions for your installed version and complete the authorization prompt when supported. ### ChatGPT Bring your Citation workspace into a ChatGPT conversation. Open Plugins and choose Add custom MCP server. Paste the Citation server address and choose OAuth authentication. Sign in to Citation, choose a workspace, and approve the permissions you need. - [Official ChatGPT setup guide](https://developers.openai.com/api/docs/guides/custom-mcp-server) ### Claude Search saved research and work on drafts from Claude. Open Settings, then Connectors, and add a custom connector. Enter Citation and the server address. Choose automatic OAuth registration when prompted. Connect, sign in to Citation, and approve access to your workspace. - [Official Claude setup guide](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) ### Gemini Connect saved documents through Gemini custom apps. On Gemini web, open Settings, then Connected Apps and custom apps. Add the Citation server address and use automatic OAuth registration. Sign in to Citation and approve workspace access. Enable the connected app in your conversation. - [Official Gemini setup guide](https://support.google.com/gemini/answer/17209137?hl=en-yt) ### Perplexity Use your saved research with a remote connector. Open Account Settings, then Connectors, and choose Custom connector. Choose Remote, enter the Citation server address, and select OAuth. Complete automatic registration and sign in to Citation to choose your workspace. - [Official Perplexity setup guide](https://www.perplexity.ai/help-center/en/articles/13915507-adding-custom-remote-connectors) ### Grok Add Citation as a custom connector in Grok. Open Grok Connectors and choose New Connector, then Custom. Enter the Citation server address and select the supported authentication option. Use OAuth when offered, or a scoped Citation token in the private authentication field. - [Official Grok setup guide](https://docs.x.ai/grok/connectors) ### Manus Give a Manus workflow access to your saved Citation work. Create a personal token for the required workspace and permissions in Citation MCP connections. In Manus, open Settings, Integrations, then Custom MCP. Enter the server address and provide the token using bearer authentication. - [Official Manus setup guide](https://manus.im/docs/integrations/custom-mcp) ### Genspark Connect Citation tools to a Genspark workflow. In Genspark, open Skills, Connectors, Community & Custom, then Add new MCP server. Enter Citation as the name, choose Streamable HTTP, and enter the Citation server address. Leave Request Header JSON empty, then choose Add Server. Complete the Citation OAuth sign in, select your workspace, review the requested permissions, then allow access. - [Official Genspark setup guide](https://www.genspark.ai/helpcenter/connectors-and-integrations) ### Mistral Vibe Use Citation in Vibe Work, formerly Le Chat. In Vibe Work, open Connectors, choose Add Connector, then Custom MCP Connector. Enter Citation as the name and the Citation server address, then choose Connect. Vibe detects authentication automatically. Complete the Citation sign in and consent flow, then enable the connector for your conversation. - [Official Mistral Vibe setup guide](https://docs.mistral.ai/vibe/work/connectors/mcp-connectors) ### Kimi Install a personal plugin with Citation tools and four skills. Download and extract the Kimi plugin package. Open Plugin Builder in Kimi Work and import the extracted plugin files. Add the plugin to your Personal marketplace, install it, and authenticate its Citation MCP connection. - [Official Kimi setup guide](https://www.kimi.com/en/help/plugins-and-skills/create) ### Microsoft 365 Copilot Find Citation research with a federated connector. Ask your Microsoft 365 administrator to configure the Citation federated connector. Register the connector OAuth client and credentials, then add its endpoint and manifest in your tenant. After administrator approval, authenticate Citation to search and read your saved research. - [Official Microsoft 365 Copilot setup guide](https://learn.microsoft.com/en-us/microsoft-365/copilot/connectors/set-up-custom-federated-connectors) ### Codex Connect your coding agent to Citation research tools. Run the setup commands in a terminal on your Codex host. Complete the Citation OAuth flow and select your workspace. Enable Citation in the agent and install the research skills when needed. Codex configuration ```sh codex mcp add citation --url https://citation.co/mcp codex mcp login citation ``` - [Official Codex setup guide](https://learn.chatgpt.com/docs/extend/mcp?surface=cli) ### Claude Code Use Citation from Claude Code and its project skills. Run the setup commands in your project. Complete Citation OAuth login and select the required workspace. Use the MCP tools directly or install the Citation skills in your project. Claude Code configuration ```sh claude mcp add --transport http citation https://citation.co/mcp claude mcp login citation ``` - [Official Claude Code setup guide](https://code.claude.com/docs/en/mcp) ### Cursor Keep research available to Cursor Agent. Add the configuration to .cursor/mcp.json in your project. Open Cursor MCP settings and authenticate Citation. Approve access to your workspace and enable the tools for Agent. Cursor configuration ```json { "mcpServers": { "citation": { "url": "https://citation.co/mcp" } } } ``` - [Official Cursor setup guide](https://cursor.com/docs/mcp) ### GitHub Copilot Add Citation tools to Copilot Chat in VS Code. Merge the configuration into .vscode/mcp.json in your project. Start the Citation server from VS Code MCP settings and complete OAuth. Select the Citation tools in Copilot Chat when working with research. GitHub Copilot configuration ```json { "servers": { "citation": { "type": "http", "url": "https://citation.co/mcp" } } } ``` - [Official GitHub Copilot setup guide](https://code.visualstudio.com/docs/agents/reference/mcp-configuration) ### OpenAI Dots Official docs identify dots and their app access. A direct custom MCP setup for a dot has not been verified here. Cloud app access is separate from a local Codex connection. A local protocol test does not verify a dot connection. - [Official OpenAI Dots setup guide](https://learn.chatgpt.com/docs/dots/computers-and-apps) ### Windsurf The current official Cascade documentation redirects to Devin Desktop. Verify your installed version and its configuration location. Cascade → Actions → Open MCP config file Windsurf configuration ```json { "mcpServers": { "citation": { "serverUrl": "https://citation.co/mcp" } } } ``` - [Official Windsurf setup guide](https://docs.devin.ai/desktop/cascade/mcp) ### Gemini CLI Use httpUrl for Streamable HTTP and approve the OAuth request with /mcp auth. .gemini/settings.json Gemini CLI configuration ```json { "mcpServers": { "citation": { "httpUrl": "https://citation.co/mcp" } } } ``` - [Official Gemini CLI setup guide](https://geminicli.com/docs/tools/mcp-server/) ### Antigravity Google Antigravity supports remote MCP with OAuth discovery and browser authentication. Agent settings → Customizations → MCP configuration Antigravity configuration ```json { "mcpServers": { "citation": { "serverUrl": "https://citation.co/mcp" } } } ``` - [Official Antigravity setup guide](https://antigravity.google/docs/mcp) ### OpenCode OpenCode v2 uses mcp.servers. Earlier versions use a different configuration shape. opencode.json OpenCode configuration ```json { "mcp": { "servers": { "citation": { "type": "remote", "url": "https://citation.co/mcp" } } } } ``` - [Official OpenCode setup guide](https://opencode.ai/v2/docs/mcp-servers) ### OpenClaw Add a Streamable HTTP server in Settings → MCP, then sign in and probe the connection. OpenClaw configuration OpenClaw configuration ```json { "mcp": { "servers": { "citation": { "url": "https://citation.co/mcp", "transport": "streamable-http", "auth": "oauth", "enabled": true } } } } ``` - [Official OpenClaw setup guide](https://docs.openclaw.ai/tools/mcp) ## What you can do - Find and read documents in the workspace you connected. - Create drafts and save reviewed edits with version checks. - Add or correct source metadata and format citations in nine styles. - Check missing citation links, incomplete source details and duplicate DOIs. - Export saved text and references as TXT, BibTeX or RIS. Citation checks review the metadata you saved. They do not establish originality or factual accuracy. MCP does not expose invitations, sharing, deletion, AI review or public web fetching. ## Keep changes under your control Every edit uses the document version the assistant read. A conflicting edit is rejected so the assistant can read and review again. Request IDs prevent duplicated changes when a client retries after a timeout. Revoke a connection in settings to stop its access and refresh tokens. Access also ends when your workspace membership is removed. Source content and document text should always be treated as reference material, never instructions for your assistant. ## Local and cloud connections The server uses Streamable HTTP with the current MCP SDK and compatibility for earlier HTTP clients. Cloud clients require a reachable HTTPS deployment. A localhost connection is available only to a client running on that computer. For desktop browser clients, an operator may need to allow the client’s exact browser origin. If your client cannot connect, check the address, authentication, granted scopes and deployment configuration before changing permissions.