Skip to content

Update Claude Desktop integration guide — setup flow has changed #2873

Description

@marcel-rbro

What needs to change

Update the Claude Desktop integration guide (sources/platform/integrations/ai/claude/claude-desktop.md). Claude Desktop's connector setup has changed since the page was last substantively updated on 2026-04-28, so the documented steps may no longer match the app.

  • Verify all three documented connection paths against the current app: the remote-server custom connector (https://mcp.apify.com), the connector-directory install, and registration via the .mcpb file.
  • Replace or remove any steps, links, or screenshots that no longer match the current configuration flow.
  • Re-check the troubleshooting section against current behavior.
  • Mirror the outcome in the Claude Desktop tab of the Apify MCP server page, which carries an abbreviated copy of the same instructions.

The installation instructions served on mcp.apify.com are a separate surface and are tracked with the MCP server, not here.

Why

Reported by the AI team: users following the current guide can hit stale setup steps, which turns a first-run integration attempt into a debugging session.

Source

Internal tracking: apify/ai-team#250.

Related: #2607 (same class of drift for the ChatGPT MCP client — worth doing in one pass). Note #2850 rewrites mcp.md; merge it before editing the tab there.

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentation.high priorityDo this ASAP! This is for mission-critical work or work that blocks other teams in their work.t-docsIssues owned by technical writing team.

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions