Skip to content

docs: Add Claude.ai integration page - #3162

Open
marcel-rbro wants to merge 10 commits into
masterfrom
docs/claude-ai-integration
Open

marcel-rbro wants to merge 10 commits into
masterfrom
docs/claude-ai-integration

Conversation

@marcel-rbro

@marcel-rbro marcel-rbro commented Nov 3, 2026 •

Copy link
Copy Markdown
Contributor

Closes #3161

Adds a Claude.ai integration page at /integrations/claude-ai. The claude.ai setup steps were previously buried in the Claude Desktop page.

Why the setup moved to the claude.ai page

I decided to move the hosted setup (the Apify plugin and the custom connector) from the Claude Desktop page to the new claude.ai page. Connectors belong to the Claude account, so a connector added in claude.ai also works in Claude Desktop. One set of steps in one place means the two pages can't drift apart. The Desktop page now covers only what is specific to Desktop, the Desktop extension, and links to the claude.ai page for the rest.

Changes

  • New page agents/claude/claude-ai.md. It follows the plugin-page template (Cursor, Codex, Grok Bot) and covers:
    • Installing the verified Apify plugin from Customize > Connectors > Discover.
    • Connecting its apify connector through OAuth.
    • A first prompt.
    • Adding a custom connector as an alternative, to choose which Apify tools Claude can use.
    • Troubleshooting and limitations.
  • Claude Desktop page: the connection methods are renamed to "Apify plugin or custom connector" and "Desktop extension" to match the new page, and the hosted setup is now a link to the claude.ai page instead of repeated steps. This also removes the outdated Settings > Connectors path, which is now Customize > Connectors.
  • Claude overview page: adds a Claude.ai card and updates the intro and description.
  • MCP server and agents quickstart pages: link to the new page.

The example prompt uses the prompt code block. The skill prompts keep the shared snippet, so they still match the other agent pages.

Related: #2873

🤖 Generated with Claude Code

Add a setup guide for claude.ai that installs the Apify plugin from the
connector directory and connects its Apify MCP connector, with a custom
connector alternative for limiting tools. Point the Claude Desktop remote
server section to it instead of repeating the steps, and link it from the
Claude overview, MCP server, and agent onboarding pages.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@marcel-rbro marcel-rbro added documentation Improvements or additions to documentation. t-docs Issues owned by technical writing team. labels Nov 3, 2026
@marcel-rbro marcel-rbro self-assigned this Nov 3, 2026
@apify-service-account

apify-service-account commented Nov 3, 2026 •

Copy link
Copy Markdown
Contributor

✅ Preview for this PR (commit 0dc3ad42) is ready at https://pr-3162.preview.docs.apify.com (see action run).

marcel-rbro and others added 2 commits November 3, 2026 12:07
Rename the Claude Desktop methods to "Apify plugin or custom connector"
and "Desktop extension" so they match the Claude.ai page, and shorten the
remote setup section to a link. On the Claude.ai page, fold the dynamic
registration warning into the sign-in step, add a tool permissions check
to troubleshooting, and update the screenshot placeholders.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@marcel-rbro
marcel-rbro requested a review from TC-MO November 4, 2026 12:33
marcel-rbro and others added 2 commits November 4, 2026 13:34
Resolve agent-onboarding.md deletion by moving the claude.ai link change to agents/quickstart.md.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Add screenshots for the plugin in Discover, the plugin's Connectors tab, and the Apify permission page. Merge the connector dialog steps, make the account choice a regular step, and split the permission checks from the warning.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@marcel-rbro
marcel-rbro marked this pull request as ready for review November 4, 2026 12:36

@TC-MO TC-MO left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Moving the hosted setup to one page makes sense, and the page follows the plugin template well. The two main points are the Team/Enterprise sentence that got lost and the leftover "connector" wording on the Desktop page. The rest are small.

I couldn't check the claude.ai UI paths. I assume you tested them live.


<ApifyPluginSkillPrompts />

## Connect without the plugin

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit, take it or leave it: on the sibling plugin pages (Cursor, Codex), setup comes first, then usage, then troubleshooting. Here an alternative setup path sits after Bundled skills. You could move it above Run your first prompt, but it's also fine where it is as the advanced path.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd keep it here, it's an advanced flow. If I were to rewrite the other pages, I'd move it as well.

Comment thread sources/platform/agents/mcp.md Resolved
marcel-rbro and others added 3 commits November 6, 2026 11:15
Restore the Team/Enterprise owner note, drop the redundant Connectors
tab screenshot, add a Troubleshooting intro, and use "extension"
instead of "connector" for the Claude Desktop extension.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@marcel-rbro
marcel-rbro requested a review from TC-MO November 6, 2026 10:57
marcel-rbro and others added 2 commits November 6, 2026 12:00
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

This branch has not been deployed

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

Labels

documentation Improvements or additions to documentation. t-docs Issues owned by technical writing team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add a Claude.ai integration page

3 participants