Skip to content

docs(integration): add Claude and Claude Code integration guide#116

Open
k1LoW wants to merge 3 commits into
mainfrom
claude-custom-connector
Open

docs(integration): add Claude and Claude Code integration guide#116
k1LoW wants to merge 3 commits into
mainfrom
claude-custom-connector

Conversation

@k1LoW
Copy link
Copy Markdown
Contributor

@k1LoW k1LoW commented May 21, 2026

Summary

  • Add a new Integration guide for connecting Claude (custom connector using remote MCP) and Claude Code (claude mcp add) to a Tailor PF app via the new Dataplane remote MCP server
  • Link the new page from the Integration section overview

Changes

  • Add docs/guides/integration/claude.md covering:
    • Creating a single OAuth2 public client (requireDPoP: false) with two redirect URIs, each labeled with the product that uses it: https://claude.ai/api/mcp/auth_callback for Claude and http://localhost:3000/oauth/callback for Claude Code (via --callback-port 3000)
    • Claude side: Organization settings > Connectors / Customize > Connectors, Add custom connector, remote MCP server URL, and OAuth Client ID under Advanced settings, matching the wording used in the Claude support article
    • Claude Code side: claude mcp add --transport http <name> https://{YOUR_APP_SUBDOMAIN}.erp.dev/mcp --client-id <CLIENT_ID> --callback-port 3000
  • Update docs/guides/integration/overview.md to reference the new page
  • Use the existing {YOUR_APP_SUBDOMAIN}.erp.dev placeholder style for app URLs to stay consistent with the rest of the docs

k1LoW added 2 commits May 21, 2026 16:27
The Tailor Platform now exposes a remote MCP server per application
(see tailor-inc/platform-planning#844), so users can let Claude and
Claude Code run Dataplane GraphQL queries and mutations on their
behalf. Document the end-to-end setup so users don't have to piece it
together from the Auth, MCP, and Claude support docs.

The guide covers a single OAuth2 client that registers both redirect
URIs (Claude's `https://claude.ai/api/mcp/auth_callback` and Claude
Code's `http://localhost:3000/oauth/callback` via `--callback-port`)
and is split into clearly labeled subsections so it's obvious which
step applies to which product.
The Tailor Platform remote MCP server that backs this integration is
still in preview, so the guide should advertise that the same way
other preview docs do (Built-in IdP uses `preview: true` in the
frontmatter and `<PreviewTag />` on the H1).
@k1LoW k1LoW self-assigned this May 21, 2026
@k1LoW k1LoW added the enhancement New feature or request label May 21, 2026
@k1LoW k1LoW requested a review from Copilot May 21, 2026 07:34

This comment was marked as outdated.

Without the Oxford comma the list reads ambiguously ("Claude and
Claude Code" can be parsed as a single compound name because "Claude
Code" itself contains "Claude"). The rest of the docs already use the
Oxford comma convention (see `getting-started/graphql.md`,
`sdk/testing.md`, etc.), so add one here for consistency.
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated no new comments.

@k1LoW k1LoW marked this pull request as ready for review May 21, 2026 07:44
@k1LoW k1LoW requested a review from a team as a code owner May 21, 2026 07:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants