Connect Craft.io to Claude Code so you can query and update your product workspace directly from your AI assistant.
For an overview of what you can do once connected, see Introduction to the Craft.io MCP server.
Before you start
You will need:
Claude Code installed and running
A Craft.io account with an Editor seat (Contributor seats do not have MCP access)
Access to at least one Workspace, Portfolio or Feedback portal in your Craft.io account
A Craft.io API key issued by your customer success team. If you do not have one, contact your CS representative directly.
Option 1: Ask Claude directly (simplest)
The easiest way is to just ask Claude to set it up for you. Open Claude Code and type:
Connect to the Craft.io MCP server at https://mcp.craft.io/mcp
Claude will run the setup command and confirm when it's done. No terminal or config file editing required.
Then run /mcp in the chat to authorize Craft.io with your API key.
Option 2: Add via the terminal
Run the following command in your terminal:
claude mcp add --transport http craft https://mcp.craft.io/mcp
Then start or restart Claude Code and run /mcp in the chat to authorize Craft.io with your API key.
Option 3: Add manually via .mcp.json
If you prefer to manage the config file directly, locate .mcp.json in your Claude Code project folder. If you do not have one yet, create it.
Add the following inside the mcpServers block:
{
"mcpServers": {
"craft": {
"type": "http",
"url": "https://mcp.craft.io/mcp"
}
}
}
If you already have other servers configured, add the "craft" block alongside them inside the existing mcpServers object. Save the file, then restart Claude Code or run /reconnect.
Authorizing Craft.io
Whichever option you used, run /mcp in the Claude Code chat. Find Craft.io in the list and follow the authentication flow. Claude will open a browser link - log in with your Craft.io credentials using your API key.
After you approve access, your browser will redirect to a localhost page. This may show a connection error, which is expected. The authorization completes in the background. Return to Claude Code to confirm.
What you can do
Claude can now access your Craft.io workspaces. Try asking:
"List my Craft.io workspaces"
"Show me the items in my product roadmap"
"Summarize feedback from the last 30 days"
Troubleshooting
The Craft.io tools are not appearing after restart
Run /mcp to check the server status. If Craft.io is listed but shows an error, re-run the setup (Option 1 or Option 2) or check that your .mcp.json is valid JSON.
The browser redirect page shows an error
This is expected. If Claude does not confirm the connection within a few seconds, paste the full URL from your browser's address bar into the chat.
I'm being asked to authorize every session
This can happen if Claude Code does not have write access to store the token. Check that your .claude folder permissions allow file writes.
Need more guidance? 🙋 Our LIVE support team (at the bottom right corner of your screen) replies to ANY question!