How to add an MCP connector (MCP server) to Tesseract
Tesseract takes any MCP server, over stdio, HTTP or SSE, and servers from the official MCP registry. You add it once in Settings → Extensions → Connectors, by its address, the command that starts it, or its settings as JSON. Every one of the 14 agent frameworks in Tesseract can then use its tools.
Checked against Tesseract 0.12.5.
How do I add an MCP server to Tesseract?
Open Settings → Extensions → Connectors and give Tesseract the server in one of three forms. Tesseract shows you what it is before anything is added.
- Open Settings → Extensions, then the Connectors tab.
- In the box at the top, paste one of these, then press Add:
- An address, for a server on the web: an http(s) link such as
https://mcp.example.com/mcp. - A command, for a server that runs on your computer over stdio, such as
npx -y @acme/notes-mcp. - Its settings as JSON: a command, its arguments and its environment.
- An address, for a server on the web: an http(s) link such as
- Look at what Tesseract shows you. For a command, you see the whole command it will run, and nothing runs before you allow it.
- Add it with the button at the bottom: Allow and add for a command, Add connector for an address. Nothing is added until you press it.
Can I paste a JSON config, like the one in a server’s README?
Yes. Tesseract reads one server’s settings, with a url or a command, or a whole block under mcpServers. It also finds the servers under servers, mcp or mcp_servers.
For example, a server that runs on your computer:
{ "mcpServers": { "notes": { "command": "npx", "args": ["-y", "@acme/notes-mcp"] } } }When the settings name several servers, Tesseract lists each one, and you choose which to add.
How do I add a server from the official MCP registry?
Press Browse directory, next to the box on the Connectors tab, and add a server from there.
- Open Settings → Extensions → Connectors.
- Press Browse directory. It lists the servers in the official MCP registry, and you can search them by name.
- Press Add on the one you want. You then see the same steps as for a pasted address or command, and nothing is added before you say so.
Does it work with Claude Code, Codex, Gemini CLI and OpenCode?
Yes. Each framework’s page on this site lists "Tesseract’s tools and your MCP servers" among what works, for all 14. That covers Claude Code, OpenAI Codex, OpenCode, Gemini CLI, Antigravity CLI, Kimi Code, Qwen Code, MiniMax Code, CodeBuddy, Grok Build, Cursor, Hermes Agent, OpenClaw and NanoClaw. You add a connector once, in Tesseract, not once per framework. Each conversation picks its own framework, so different conversations can run different ones.
How do I make an "Add to Tesseract" button for my connector?
Use the free maker at tesseract.dev/connect/. It gives you a badge in Markdown for your README, and a plain link.
- Open tesseract.dev/connect/.
- Type your connector’s name.
- Paste your server’s address, or its settings as JSON.
- Copy the Markdown into your README, or copy the link.
The badge links to a tesseract.dev page, not straight to the app, because GitHub strips links that are not http(s). The address may be at most 2,048 characters. The settings must be one JSON object of at most 20,000 characters. The settings are written into the link itself, only encoded (base64url), so leave real keys and tokens out of them.
What happens when someone clicks the button?
They see your connector on tesseract.dev first, and nothing opens by itself.
- The page says what the connector is: the web address it reaches, or the command it runs, written out in full.
- It offers Open in Tesseract, and Get Tesseract for someone who doesn’t have the app.
- Open in Tesseract opens Settings → Extensions → Connectors with the connector already in the box, marked "This came from a link".
- Tesseract shows it again before anything is added, and asks before anything runs.
A link whose url= or config= can’t be read shows "This link doesn’t name a connector".
Is this the same as using Tesseract inside Claude or ChatGPT?
No. This guide brings other MCP servers into Tesseract; Tesseract in Claude and ChatGPT is the other way round, with Tesseract added to your chat app by one address.
Questions
Can Tesseract use any MCP server?
It takes any MCP server over stdio, HTTP or SSE.
Do I need to set the server up separately for Claude Code and for Codex?
No. You add it once in Settings → Extensions → Connectors, and every framework in Tesseract can use it.
Can I paste the mcpServers JSON from a README?
Yes. Tesseract reads one server’s settings or a whole mcpServers block.
Where do I find servers from the official MCP registry?
In Settings → Extensions → Connectors, under Browse directory.
Does an "Add to Tesseract" link add the connector by itself?
No. Tesseract shows it to you again before anything is added, and asks before anything runs.
More guides
- Use Claude Code, Codex and other coding agents in one appTesseract runs 14 coding agents in one free desktop app. Pick one for each conversation, switch any time, and sign in with your own plan or a key.
- Does the AI agent run on my computer or in the cloud?The agent runs on your computer, or on your other computers and servers. The AI model runs at the provider you pick, unless you use a local model.
- What does an AI task cost in Tesseract?Tesseract is free. Your Claude or ChatGPT plan, an API key or the free allowance runs the AI. Pictures and video use paid models.