Skip to main content
Checked on Izumi 0.5.7, 2026-11-20. MCP (Model Context Protocol) is the way an AI tool calls Izumi. You still ask your own tool, for example ChatGPT or Claude. The tool calls Izumi, gets passages from your company’s documents and answers with a source.

What you get

  • You ask Izumi from a tool you already use. You do not open a separate app.
  • The tool sees only what you may see in Izumi, in all your companies. The connection carries your permissions, nothing more.
  • Izumi does not write the answer for the tool. Izumi returns passages with source, link, author and freshness, and the AI tool writes the answer.
  • Optional: the tool can propose a note. The note goes to the Review queue, and an editor of the domain approves or rejects it. Until then nobody can find it by search.

Two ways to connect

The server address is the address of your Izumi with /mcp at the end. On the demo installation (invitation only) it is https://izumi.akiaconsulting.com/mcp.
OAuth needs an Izumi server with OAuth turned on. The administrator sets this up once, see the Installation tab.

Scopes

  • read: search and read documents. Always on.
  • propose: propose notes that an editor reviews. It is ticked by default on the approval page and you can untick it. A token with only read can search but cannot propose.
  • push exists for the push API and is not used over MCP.

Pick your tool

ChatGPT

Add Izumi as a plugin, OAuth, no token.

Claude

claude.ai and Claude Desktop, one connector, one account.

Slack

Izumi in Slackbot. The steps are split between the Izumi admin, the Slack admin and every user.

Claude Code

Terminal and editor. OAuth or a personal token.

Other clients

Address and header for any MCP client. Not checked live.

Tools and example questions

The five tools the AI sees, errors and example questions.

Where you see and revoke connections

  • In Izumi open My tokens and profile. All connections and tokens are in the Tokens section. An OAuth connection is a row marked Connected app, with the client name and address.
  • Revoke ends the connection at once, without a confirmation. The client then asks you to connect again. The exception is Slackbot, see the Slack page.
  • The client’s calls show in the Access log.

Limits

  • 60 calls per minute per token. After that the tool returns the error rate_limited.
  • Streamable HTTP only. A client that supports only local (stdio) servers does not work.
  • A connection lasts at most 90 days. After that the client asks you to connect again.
Not checked live: whether an OAuth connection that is not used for more than 30 days asks for a new connection before the 90 days end (the server issues a renewal of access valid for 30 days from each use, and the connection itself ends after 90 days).
Not checked live: Cursor, Windsurf, Cline, VS Code, Zed and Continue. They only have the generic page Other clients.

Troubleshooting

  • The tool says it has no Izumi tools: the connection is not on in that chat or it expired. See the page for your tool.
  • The tool returns an error: see the table of errors on the page Tools and example questions.
  • The connection was revoked and the tool does not offer to reconnect: connect it again following the page for that tool.