JetBrains IDEs MCP setup

Where to configure

Config file locations

Plugin settings	`Settings → Tools → AI Assistant → MCP Servers`
Project file (optional)	`.idea/mcp.json when supported by your IDE version`

Steps

Good setup flow

Install or update JetBrains AI Assistant with MCP support enabled.
Open Settings → Tools → AI Assistant → MCP Servers → Add server.
Name it pickwise, set transport to HTTP/SSE, URL to https://mcp.pickwise.dev/mcp.
Add custom headers: Authorization (Bearer + API key) and X-Pickwise-Client-Id (your email).
Apply, restart the IDE if prompted, then verify tools in the AI chat tool list.

JetBrains IDEs-specific notes

UI-first setup is preferred — only use JSON files if your IDE version exposes them.
Match the plugin version your platform team standardizes on; MCP UI moved between recent releases.

Template

{
  "mcpServers": {
    "pickwise": {
      "url": "https://mcp.pickwise.dev/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-key>",
        "X-Pickwise-Client-Id": "<your-work-email>"
      }
    }
  }
}

Example (replace with your values)

{
  "mcpServers": {
    "pickwise": {
      "url": "https://mcp.pickwise.dev/mcp",
      "headers": {
        "Authorization": "Bearer pw_live_7f3a9c2e1b4d8f6a0c5e",
        "X-Pickwise-Client-Id": "jane@yourcompany.com"
      }
    }
  }
}

Good setup checklist

Sign in and create API keys at https://intelligence.pickwise.dev/api-keys — not from chat or task prompts.
MCP endpoint in IDE config is exactly https://mcp.pickwise.dev/mcp over HTTPS (not the setup guide URL).
Authorization uses Bearer <api-key>; X-Pickwise-Client-Id is the same email you use on the portal.
PickWise MCP tools appear in the IDE after a full restart (not just reload window).
Your task standard is published before developers begin work in the IDE (pickwise_begin_task).

Troubleshooting

Common things to debug

Most connection issues are config path, JSON/TOML syntax, or credentials — not PickWise itself.

What you see	Likely cause	What to try
401 Unauthorized or authentication failed	Wrong API key, revoked key, or email header does not match your PickWise account.	Create a fresh key at https://intelligence.pickwise.dev/api-keys. Copy the full pw_live_… value once. Match X-Pickwise-Client-Id to your portal login email exactly.
PickWise tools never appear in the assistant	Config file path is wrong, JSON is invalid, or the IDE was not restarted after editing.	Validate JSON (trailing commas break parsers). Save the file, quit the IDE completely, reopen, and check the MCP server list.
Connection error or timeout	Corporate proxy, offline VPN, or typo in the URL.	Confirm https://mcp.pickwise.dev/mcp is reachable from your machine. Try curl with the same headers if your security team allows it.
Agent runs but policy decisions are not logged	Task prompt missing, standard not published, or a different MCP server is active.	Ensure the task standard is published and the developer uses pickwise_begin_task (or pickwise_load_standard with the standard ID). Ensure only one pickwise entry exists in mcpServers.

Other IDEs

Using a different client?

Cursor VS Code Windsurf Claude Desktop OpenAI Codex