Start a Discovery
Browse documentation

Connecting Claude

Preview This capability is in Preview and may not be enabled for your organization yet. About release stages

Connect Claude Code, Claude Desktop, or claude.ai to your Neuralift MCP server.

Connecting Claude to Neuralift lets you ask questions in Claude that are answered from your published segments. No copy-pasting exports into chat. At the end of this guide, Claude will list your published use cases on request. Claude Code is the recommended path: it supports Neuralift’s API-key authentication directly and takes about a minute to set up.

Before you begin

  • MCP is enabled for your organization (see the overview); your Neuralift team will confirm your exact endpoint when enabling MCP.
  • You have a Neuralift API key. An organization admin creates these (see roles and permissions).
  • Your organization has at least one published use case; MCP returns published results only.

Connect Claude Code

  1. In a terminal, add Neuralift as an MCP server, replacing the placeholder key with your own:

    claude mcp add --transport http neuralift https://app.neuralift.ai/mcp \
  --header "Authorization: Bearer nlmcp_xxxxxxxxxxxx"

    By default the server is added for the current project. Add --scope user to make it available in all of your projects.

  2. Start (or restart) Claude Code and run /mcp. The neuralift server should show as connected, with its tool count listed.

  3. Send a first prompt to verify end to end:

    List my data runs.

You should now see your organization’s published use cases, with their goals and completion dates. If you do, the connection is working.

Tip. Your shell history will contain the key if you paste it into the command. Prefer reading it from a secret manager, and treat the key like a password.

Connect Claude Desktop or claude.ai (custom connector)

Claude’s custom connectors attach a remote MCP server to Claude Desktop and claude.ai:

  1. On a Pro or Max plan, go to Settings → Connectors (under “Customize”). On Team and Enterprise plans, an Owner adds the connector under Organization settings → Connectors, after which members enable it from their own Connectors settings.
  2. Click Add custom connector.
  3. Enter a name (for example Neuralift) and the server URL https://app.neuralift.ai/mcp.
  4. Save, then enable the connector in a conversation and ask: “List my data runs.”

Note. The custom-connector authentication settings are OAuth-oriented, and Neuralift authenticates with a static API key. Support for this combination varies by Claude plan and client version. If the connector cannot authenticate, use Claude Code (above), or contact support@neuralift.ai for the current recommended bridge configuration for Claude Desktop.

Troubleshooting

  • The server shows as failed or you see an authentication error. The key is missing, mistyped, revoked, or expired. Check the header is exactly Authorization: Bearer nlmcp_... with a space after Bearer, and ask your admin to confirm the key is still active in Settings → API keys.
  • The connection is refused with a “forbidden” error. MCP is not yet enabled for your organization. Contact your Neuralift team.
  • Claude connects but finds no data. Your organization has no published use cases yet, or you’re asking about a run that hasn’t been published.

Next steps