Skip to main content

Claude Setup Guide

Claude provides native MCP support, making it the recommended platform for accessing blockchain data through natural language. You connect once with your Hgraph account — no API keys to copy or paste. Claude signs you in through Hgraph's secure OAuth flow and stays connected across web, desktop, and mobile.

Hgraph MCP URL

https://mcp.hgraph.com/mcp
Prefer an API key, or connecting a script?

This guide covers the recommended OAuth sign-in. If your setup can't use OAuth, or you're connecting a script or agent with no browser, see API Key Access instead.

Prerequisites​

  1. Free Hgraph account

    • Create one at app.hgraph.com — no credit card required for the free tier.
    • You'll sign in with this account when you connect. There's no API key to copy.

  2. Claude account

    • Claude Pro subscription required for custom connectors.
    • Available at claude.ai; Claude Desktop: download here.

Set up in Claude Web & Desktop​

Step 1: Confirm your organization is set up​

The Hgraph connector is enabled per organization, so who connects first matters:

  • If you're an organization admin or owner: the first time you connect, Hgraph automatically provisions a shared "Claude Connector" project and API key for your org. Nothing to do in advance — continue to Step 2.
  • If you're a team member (not an admin): an admin must have already connected once and added you to the Claude Connector project. If you haven't been added, you'll get an access error at Step 5 — ask an admin to complete Give your team access first.

Step 2: Open Claude Settings​

In Claude web or Claude Desktop, click your profile icon in the bottom-left corner and select Settings.

Step 3: Navigate to Connectors​

In Settings, click Connectors in the left sidebar, then scroll down and click Add custom connector.

Step 4: Add the Hgraph Connector​

Fill in the form:

  • Name: Hgraph
  • MCP URL: https://mcp.hgraph.com/mcp

Click Add. You do not enter an API key — leave any optional key/secret fields blank.

Step 5: Sign in and approve​

Claude will prompt you to connect. A browser window opens on the Hgraph sign-in page:

  1. Sign in with your Hgraph account (or log in if you already have a session).
  2. If you belong to more than one organization, choose which one this connection should use.
  3. Click Approve to grant access.

The window closes and Claude shows Hgraph as connected.

Step 6: Test your setup​

Start a new chat, enable the Hgraph connector, and try:

"Could you provide an overview of token 0.0.1055459?"

When it's working, Claude indicates it's using the Hgraph tools and returns real token data (name, symbol, supply, etc.). For more examples, see the Examples & Use Cases page.

Understanding what just happened​

Behind the scenes, Claude authenticated to Hgraph over OAuth and now sends a short-lived token with each request. The Hgraph MCP Server validates it and queries Hgraph's data platform for live on-chain data. The MCP automatically picks the optimal data source (GraphQL, SQL, or RPC) for each question — no manual configuration.

Mobile support

Once configured in Claude web or desktop, the connector syncs to mobile apps automatically. Mobile apps inherit settings but may have limited features compared to desktop.

Give your team access​

Only members of your organization's Claude Connector project can use the connector. As an org admin, after you've connected once (the steps above), add teammates so they can connect too:

  1. Sign in to the Hgraph App and open Projects.
  2. Open the Claude Connector project (created automatically when you first connected).
  3. Add each teammate as a project member.

They can now follow the setup steps above to connect with their own Hgraph account.

Set up in Claude Code CLI​

Claude Code provides advanced MCP integration for developers working in the terminal or IDE.

  1. Install Claude Code following the official installation guide.

  2. Add the Hgraph connector:

    claude mcp add --scope user --transport http hgraph https://mcp.hgraph.com/mcp

    The --transport http parameter uses modern Streamable HTTP transport (not deprecated SSE), providing a single endpoint with better reliability and session resumability.

  3. Authenticate. In a Claude Code session, run:

    /mcp

    Select hgraph, choose Authenticate, and complete the browser sign-in and approval. Claude Code stores the credentials for future sessions.

  4. Verify the connection:

    claude mcp list

    You should see hgraph in the list of connected MCPs.

How to use in Claude Code​

Start a conversation and ask questions about on-chain data — Claude Code automatically calls the appropriate Hgraph tools.

Example prompt: "Show me the top 5 ERC-20 tokens by market cap"

Auto-approval configuration​

To avoid approving every Hgraph tool call, add Hgraph tools to your allowlist:

claude config set allowlist "mcp__hgraph__*"

Troubleshooting​

Connector not appearing in settings​

Ensure you have an active Claude Pro subscription (custom connectors require Pro).

Access error when connecting​

You haven't been granted access to your organization's connector yet. An org admin needs to connect once and add you to the Claude Connector project — see Give your team access.

Connection errors or "Connector offline"​

  • Make sure you completed the browser sign-in and clicked Approve.
  • Remove the connector and re-add it with the exact URL https://mcp.hgraph.com/mcp, then re-authenticate.

Connector doesn't work in chat​

  • Verify the connector is enabled in your chat.
  • Try starting a new conversation.

Still not working?​

  1. Confirm you can sign in at app.hgraph.com.
  2. Check your organization's plan and that you're a member of the Claude Connector project.
  3. Contact support or join our Discord community.

Next Steps​

Need help? Visit our support page or join our Discord community