Skip to main content

Zed with Keeptrusts

Zed supports both remote MCP servers and custom OpenAI-compatible providers. Configure either path independently, or use both.

Add Keeptrusts MCP tools

Open Settings → AI → MCP Servers, choose Add Remote Server, and enter:

  • URL: https://<published-hostname>/mcp
  • Header: Authorization: Bearer <client-api-token>

Use Zed's secure settings flow for the credential and do not commit a raw token. The server indicator should become active after Zed discovers its tools.

See Zed's MCP documentation for the current UI and tool-permission controls.

Route Zed model requests

First start the local gateway as shown in Gateway Setup for IDEs. Then open Zed's Agent Settings, add an OpenAI-compatible provider, and enter:

FieldValue
Provider namekeeptrusts
API URLhttp://127.0.0.1:41002/v1
Model IDA model returned by GET /v1/models
API keyA Keeptrusts client API token
Context windowThe value documented by the selected upstream model

Zed stores provider keys entered through its settings UI in the system keychain. Select the new provider/model for the Zed feature you want to test. Zed's edit prediction and external-agent paths have separate configuration boundaries; a model selected for Zed Agent does not automatically cover them.

See Zed's API-access documentation for the current OpenAI-compatible provider fields.

Verify

Run kt events tail --since 10m --follow, send a Zed Agent request with the Keeptrusts model selected, and confirm the event. Test MCP tool discovery separately.

Next steps