MCP servers
Tools, prompts and views from Model Context Protocol servers over stdio or HTTP, with OAuth sign-in and per-tool approvals.
KodaCode speaks MCP 2026-07-28 only. Add servers in Preferences → MCP servers. Your servers apply to every project. A project can add its own servers in .koda/mcp.toml.
Add a server
Choose Add server:
| Field | |
|---|---|
| Name | |
| Transport | Command (stdio) or URL (HTTP) |
| URL | For HTTP |
| Headers | One Name: value per line. $secret keeps a value in the keychain. |
| Client ID | Only if the provider asks for one registered for KodaCode |
| Command, Arguments | For stdio. One argument per line. |
| Environment | One NAME=value per line. $secret keeps a value in the keychain. |
| Approval | Default, Auto, Writes, Always or Never |
For each server, you can Approve it, Sign in or Sign out (OAuth), Restart it, enable or disable it, edit it and remove it. A server in a project's .koda/mcp.toml starts only after you approve it. Changes apply from the next session.
Approvals
| Approval | When it asks |
|---|---|
| Auto | For every tool, unless the server marks the tool read-only |
| Writes | For every tool that is not read-only |
| Always | For every call |
| Never | Never |
You set the default in Permissions & sandbox. A server's own approval wins over the default.
What servers can do
- Tools appear in the transcript as plug rows with the server's tool name.
- Prompts appear in the
/command list, marked mcp. - Views: a server's app view shows inline in the transcript, with Open in its own tab and Bring back here. Calls and links that a view requests need your approval.
- Questions: a server can ask for input during a call ("Input requested by…"). You can answer, choose Give nothing so that it continues without the input, or choose Stop the whole call.
- Background tasks: a long tool call can run as a task in Autonomous tasks. The agent waits for it with
check_taskor stops it withcancel_task.
config.toml
[[mcp_server]]
name = "linear"
transport = "http"
url = "https://mcp.linear.app/mcp"
approval = "writes"
Other keys: enabled, command, args, env, cwd, headers, enabled_tools, disabled_tools, startup_timeout_secs (30), tool_timeout_secs (300) and client_id.