Skip to content
Nhost Documentation
SupportDashboard

Claude

Add your deployed Backend MCP Server to Claude as a custom connector; Claude handles the OAuth2 flow.

MCP Claude custom connector remote MCP OAuth2

Claude connects to Backend MCP as a custom connector — add it once from settings and Claude handles the OAuth2 flow.

  1. Open Settings and go to Connectors (in some versions, Customize → Connectors).
  2. Click + Add custom connector.
  3. Give it a name (for example “My App”) and enter your service URL, https://mcp.acme.com.
  4. Click Add. You are redirected to your OAuth2 consent page to authorize the client.
  5. Approve the request. Once connected, the assistant can call the MCP tools.

On the consent page you will see the requested scopes — typically openid, offline_access, and either graphql or graphql:role:<role> when a role is enforced.

Verify the connection

Section titled “Verify the connection”

Once connected, ask the assistant to describe your data model or run a simple read, for example:

Prompt

What tables can you see? Use the MCP tools.

The assistant should call get-schema, then answer using your schema. If it reports an authorization error, re-run the authorization flow; if a query is denied, check that the enforced role has permission for it (see Roles & permissions).