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