Install for Zed

1. Mint a token

Open API tokens, create a token, copy the value (shown once).

A safe starter set of abilities:

forms:read, submissions:read, submissions:write, webhooks:read, insights:read.

2. Edit settings

text

~/.config/zed/settings.json

Zed's MCP key is context_servers at the top level - not nested under assistant. (Older guides showed "assistant": { "mcp_servers": ... }; that schema is no longer read.)

json

{
  "context_servers": {
    "formspring": {
      "url": "https://formspring.io/mcp-server",
      "headers": {
        "Authorization": "Bearer your-api-token"
      }
    }
  }
}

Save the file. Zed reloads settings.json automatically - no restart needed.

If a headers.Authorization value isn't set, Zed tries to start the standard MCP OAuth flow instead, which Formspring's server doesn't expose. Make sure the header is present.

3. Open the assistant

⌘? (macOS) or Ctrl+? (Linux). Tools appear in the composer's tool list.

Try a prompt

"List my forms."

"Show me the last 10 submissions for the contact form, grouped by status."

"Draft an autoresponder for the contact form. Friendly tone. Don't save it - just show me the preview."

What's next

Tools → - full catalogue
Prompt examples → - paste-ready workflows
Troubleshooting → - 401/403 fixes