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(needscommand, optionalargsandenv) orstreamable_http(needsurl, optionalheaders)enabled— must betruefor Kition to connect the server
[[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 examplefiles__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
Agent tool calls
Read the runtime tool names, how availability is decided, and the inputs, outputs, errors, and changed files shown in the Agent timeline.
Agent approvals and safety boundaries
Use the shell-command approval card and kit drafts without assuming Kition has a universal per-tool permission editor.