---
title: "Connect Claude to Narwhal MCP | Narwhal API"
description: "Connect Claude Code or the Claude app to Narwhal and sign in with your Narwhal account."
url: "https://narwhalapi.com/docs/mcp/claude"
---

# Connect Claude to Narwhal MCP

Connect Claude Code or the Claude app to Narwhal and sign in with your Narwhal account.

Claude Code supports remote HTTP MCP servers and can sign in to them. Add the Narwhal server, then sign in with your Narwhal account.

## Claude Code

Add the server with this command:

Terminal

```
claude mcp add --transport http narwhal https://api.narwhalapi.com/mcp
```

Then sign in from Claude Code by running `/mcp`

Choose the Narwhal server, sign in with your Narwhal account, and choose Allow on the Narwhal consent screen.

If your client cannot sign in, use your API key instead.

Run this command, keeping the variable placeholder quoted so Claude Code can resolve it when it connects:

Terminal

```
claude mcp add --transport http narwhal https://api.narwhalapi.com/mcp \
  --header 'Authorization: Bearer ${NARWHAL_API_KEY}'
```

The command configures the hosted Streamable HTTP endpoint at `https://api.narwhalapi.com/mcp`. Set NARWHAL_API_KEY in the environment where you run Claude Code, and keep the key private.

## Claude web and Desktop connectors

The Claude app signs in to Narwhal through a custom connector. See [Connect the Claude app to Narwhal MCP](https://narwhalapi.com/docs/mcp/claude-app.md).

If the app cannot sign in, it can send your API key through Request headers, a beta feature available to a limited set of organizations, with authentication set to No sign-in.

If Request headers is missing from the Add custom connector dialog, use Claude Code with the command above, or Cursor or VS Code.

Anthropic's remote connector requests originate from Anthropic's cloud infrastructure, so the endpoint must be publicly reachable. See [Claude's MCP documentation](https://code.claude.com/docs/en/mcp) for current client behavior.

## Verify the connection

Open the client's MCP server list and confirm that `narwhal` is connected. For a command-line check, run `claude mcp get narwhal`.

Then ask the client to list the available Narwhal tools. Tool discovery costs nothing; each successful `tools/call` costs one call at the price of its API.

Use the [main MCP guide](https://narwhalapi.com/docs/mcp.md) for the public tool list, arguments, response shape and credit rules.

Was this page helpful?
