Skip to content

Connect an MCP server

Open Settings → MCP Servers to add a server. After it connects, Kora makes its tools available to the selected model and adds its prompts to the / skill palette.

  1. Open Settings → MCP Servers.
  2. Add a server and select its transport.
  3. Complete the fields listed below.
  4. Save and wait for the status indicator to turn green.
Transport Use case
stdio Local servers launched as a child process
sse Remote servers or hosted MCP endpoints (Streamable HTTP)
Field Example
Name filesystem
Command npx
Args -y @modelcontextprotocol/server-filesystem /allowed/path
Env API_KEY=... (optional)
Field Example
Name context7
URL https://mcp.context7.com/sse
Headers Authorization: Bearer ... (optional)
  • Server not appearing in chat → open Settings → MCP Servers and check the status indicator next to the server. Green = connected, yellow = connecting, red = error (hover for the message).
  • Tool calls fail (stdio) → check the server’s stderr in Kora’s logs (View → Toggle Logs, Cmd+L).
  • Tool calls fail (sse) → verify the URL and any required auth headers.
  • Server crashes on startup (stdio) → verify the command and arguments; test the exact same command in your terminal first.
  • SSE server returns connection errors → confirm the URL uses http:// or https:// and is reachable from the Mac.

See also: Skills — prompts exposed by an MCP server are automatically available as skills.