LinkedIn MCP Troubleshooting: Fixes for Claude Desktop, ChatGPT & Cursor
· how-to
Most Item 12 MCP issues fall into five buckets: authentication, workspace scope, LinkedIn connection, client config, or review-queue expectations. This guide walks through each — applicable to Claude Desktop, ChatGPT, Cursor, and Windsurf.
401 or authentication errors
- Confirm the header is exactly: Authorization: Bearer YOUR_TOKEN (space after Bearer)
- Regenerate the token in Item 12 Settings if it was revoked or copied with extra whitespace
- Remote URL must be https://item12.com/mcp — not localhost unless using local dev bridge
Tools not appearing in the client
- Reload MCP after config changes — restart Claude Desktop, Cursor, or Windsurf
- ChatGPT: confirm Developer mode is on and the Item 12 app is enabled for the chat
- Claude: check Connectors list or claude_desktop_config.json syntax (valid JSON)
- Cursor/Windsurf: verify mcp.json / mcp_config.json is valid JSON with url + headers
Wrong workspace or empty data
- MCP uses your active workspace — switch in the Item 12 web app before creating a token
- Call switch_workspace via MCP if you manage multiple orgs
- New workspaces need LinkedIn connected in Settings before search/send tools work
LinkedIn search or send failures
- Connect LinkedIn in Item 12 Settings → hosted auth must show linkedin_ready
- Sends queue for review — MCP send_message does not bypass the human approval queue
- 2nd/3rd-degree contacts may need an invitation before a DM — MCP will suggest invite or InMail
Do I need mcp-remote for Item 12?
Only if your client requires stdio MCP (some Claude Desktop configs). ChatGPT and Cursor connect directly to the hosted URL. Item 12 is not a local stdio server.
Can I use the same token on multiple devices?
Yes — one token works across Claude Desktop, ChatGPT, and Cursor simultaneously. Revoke and recreate if compromised.
Where do I get help?
Re-run the setup checklist, verify LinkedIn in Settings, and test a read-only prompt like list workspaces before search or send tools.