Claude Code

Connect your feedback.tools surveys to Claude Code (the CLI) so you can ask about your feedback from the terminal — "What are the top bugs this month?", "Summarize the latest responses." It reads your survey data and can import feedback, but can't change or delete anything.

Need a token first? See Before you start.

There are two ways to add it. Option A (one command) is quickest; Option B edits the config file directly, which is handy if you want to check it into a project.

Option A — One command

Run this in your terminal, replacing mcp_live_YOUR_TOKEN_HERE with your token:

claude mcp add --transport http feedback-tools https://feedback.tools/mcp \
  --header "Authorization: Bearer mcp_live_YOUR_TOKEN_HERE"

By default the server is added at local scope (this project, just you). To make it available everywhere, add --scope user; to share it with your team via a checked-in .mcp.json, use --scope project.

Option B — Edit the config file

Add the server to your MCP config yourself:

• Project (shared, checked into git): .mcp.json in the project root.
• User (all your projects): ~/.claude.json.

{
  "mcpServers": {
    "feedback-tools": {
      "type": "http",
      "url": "https://feedback.tools/mcp",
      "headers": {
        "Authorization": "Bearer mcp_live_YOUR_TOKEN_HERE"
      }
    }
  }
}

Replace mcp_live_YOUR_TOKEN_HERE with your token and save.

Keep "type": "http". An entry with a url but no type is read as a local (stdio) server and skipped.

Prefer not to commit the token? .mcp.json supports env expansion — use "Authorization": "Bearer ${FT_TOKEN}" and set FT_TOKEN in your shell. A project-scoped server also asks for your approval the first time; run claude to approve it.

Verify

Check it's registered:

claude mcp list

feedback-tools should be listed as connected. Then start Claude Code and ask:

List my surveys in feedback.tools.

Claude will ask permission to use the tool the first time — allow it. If your surveys come back, you're connected. Try "What's the CSAT for my Onboarding survey?" next.

Troubleshooting