AI agent

Connect MCP servers

Add external MCP servers through the `mcp.toml` configuration file; Kition has no MCP settings pane.

Updated

By Kition Docs

Verified against Kition 0.2.0 (7d49036f) on 2026-11-06

Current product status

Kition Settings does not include an MCP pane. External MCP servers are configured in a file, mcp.toml, in the .kition folder of your home directory (~/.kition/mcp.toml; on Windows, %USERPROFILE%\.kition\mcp.toml). When the KITION_CONFIG_DIR environment variable is set, the file is read from that folder instead.

Kition reads the file when it starts and connects every enabled server. Restart Kition after editing the file. There is no per-workspace .kition/mcp.json.

Server entries

  • name — required; no spaces, slashes, colons, or __
  • transport — stdio (needs command, optional args and env) or streamable_http (needs url, optional headers)
  • enabled — must be true for Kition to connect the server
toml
[[server]]
name = "files"
transport = "stdio"
enabled = true
command = "/path/to/mcp-server"
args = ["--root", "/path/to/folder"]

[[server]]
name = "tracker"
transport = "streamable_http"
enabled = true
url = "https://mcp.example.com/mcp"

How MCP tools appear

  • Each server tool is offered to the Agent as server__tool, for example files__read_file
  • The timeline labels the call as MCP server: tool
  • Kition waits up to 15 seconds to connect a server and up to 60 seconds for a tool call
  • A server that fails to connect is skipped; its tools are not offered

Safety

MCP tool calls run without a confirmation step, and a stdio server runs as a local program with your account’s permissions. Connect only servers you trust, give them least-privilege credentials, and pin their versions.

Values in env and headers are stored in plain text in mcp.toml. Keep tokens out of shared folders and backups, and rotate them if the file may have been exposed.

Implementation sources

Related pages

Ready when you are.

Kition is a desktop AI workspace for connected documents, structured tables, editable designs, whiteboards, visual workflows, and reviewable AI agents.