Skip to content
View as MarkdownOpen this guide as plain text

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

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

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

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

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

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

Genspark

MCP connection. Connect Citation tools to a Genspark workflow.

Custom connectors depend on account availability and organization policies.

  1. Open Skills or Connectors and choose a custom MCP connection.
  2. Enter the Citation server address and configure the offered authentication method.
  3. Authorize Citation or provide a scoped token in the private authentication field.
MCP server address
https://citation.co/mcp

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 connector administration and add an MCP connector.
  2. Choose Streamable HTTP, enter the Citation server address, and select OAuth with automatic registration.
  3. Sign in to Citation and enable the connector for your conversation.
MCP server address
https://citation.co/mcp

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

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.

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.

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.

Yuanbao

Assistant bot. A Citation agent distributed through Tencent Yuanqi.

Requires Yuanqi agent publication and a verified private account connection. The Citation agent is not available yet.

  1. A publisher configures Citation tools in a Yuanqi agent and verifies private user authentication.
  2. The agent must pass the required Yuanbao distribution review.
  3. Use its published agent link when available. Never share personal tokens in chat.

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.

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.

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.

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

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

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"
    }
  }
}

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"
    }
  }
}

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.

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.

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.

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.

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.

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.

Genspark

Connect Citation tools to a Genspark workflow.

Open Skills or Connectors and choose a custom MCP connection. Enter the Citation server address and configure the offered authentication method. Authorize Citation or provide a scoped token in the private authentication field.

Mistral Vibe

Use Citation in Vibe Work, formerly Le Chat.

In Vibe Work, open connector administration and add an MCP connector. Choose Streamable HTTP, enter the Citation server address, and select OAuth with automatic registration. Sign in to Citation and enable the connector for your conversation.

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.

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.

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
codex mcp add citation --url https://citation.co/mcp
codex mcp login citation
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
claude mcp add --transport http citation https://citation.co/mcp
claude mcp login citation
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
{
  "mcpServers": {
    "citation": {
      "url": "https://citation.co/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
{
  "servers": {
    "citation": {
      "type": "http",
      "url": "https://citation.co/mcp"
    }
  }
}
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.

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
{
  "mcpServers": {
    "citation": {
      "serverUrl": "https://citation.co/mcp"
    }
  }
}
Gemini CLI

Use httpUrl for Streamable HTTP and approve the OAuth request with /mcp auth.

.gemini/settings.json

Gemini CLI configuration
{
  "mcpServers": {
    "citation": {
      "httpUrl": "https://citation.co/mcp"
    }
  }
}
Antigravity

Google Antigravity supports remote MCP with OAuth discovery and browser authentication.

Agent settings → Customizations → MCP configuration

Antigravity configuration
{
  "mcpServers": {
    "citation": {
      "serverUrl": "https://citation.co/mcp"
    }
  }
}
OpenCode

OpenCode v2 uses mcp.servers. Earlier versions use a different configuration shape.

opencode.json

OpenCode configuration
{
  "mcp": {
    "servers": {
      "citation": {
        "type": "remote",
        "url": "https://citation.co/mcp"
      }
    }
  }
}
OpenClaw

Add a Streamable HTTP server in Settings → MCP, then sign in and probe the connection.

OpenClaw configuration

OpenClaw configuration
{
  "mcp": {
    "servers": {
      "citation": {
        "url": "https://citation.co/mcp",
        "transport": "streamable-http",
        "auth": "oauth",
        "enabled": true
      }
    }
  }
}

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.