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.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

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