Docs MCP
Connect Claude
Connect Claude Code, Claude Desktop or the Claude connector to the MCP server of a Snapsbrew instance.
You can connect Claude to the MCP server in three ways:
| Client | Credential | Section |
|---|---|---|
| Claude Code | API token | Claude Code |
| Claude Desktop | API token, through mcp-remote |
Claude Desktop |
| Claude custom connector | OAuth 2.0 | Claude custom connector |
The examples use the host https://snapsbrew.example. Replace it with the APP_URL of your instance.
Before you start
- Make sure that the MCP server is on.
MCP_ENABLEDmust betrue. Read MCP server. - For Claude Code and Claude Desktop, create an API token. Open Account > Developers and click New token. Copy the token when it appears.
Claude Code
-
Run this command in a terminal. Replace
<your-token>with your API token.claude mcp add --transport http snapsbrew https://snapsbrew.example/mcp \ --header "Authorization: Bearer <your-token>" -
Restart the Claude Code session.
-
Ask Claude to call the
whoamitool. The tool returns your account and your company.
Claude Desktop
Claude Desktop connects through mcp-remote. The mcp-remote bridge needs Node.
-
Open the MCP configuration file of Claude Desktop.
-
Add this server entry. Replace
<your-token>with your API token.{ "mcpServers": { "snapsbrew": { "command": "npx", "args": [ "mcp-remote", "https://snapsbrew.example/mcp", "--header", "Authorization: Bearer <your-token>" ] } } } -
Restart Claude Desktop.
Claude custom connector
A connector uses OAuth 2.0. You do not paste a token. The connector registers itself and then asks you to approve the connection.
Prepare the instance
The owner of the instance does these steps one time.
- Make sure that the Passport keys exist. Read OAuth for the MCP server.
- Make sure that
MCP_REDIRECT_DOMAINSincludes the Claude hosts. The default value ishttps://claude.ai,https://claude.com.
Add the connector
- In Claude, add a custom connector.
- Use
https://snapsbrew.example/mcpas the URL. - If the browser asks you to sign in to Snapsbrew, sign in.
- Read the consent screen. It shows the name that the client gave itself, and what the client can do.
- To approve the connection, click Connect. To refuse it, click Cancel.
The consent screen tells you that Snapsbrew did not review the application. Approve it only if you started the connection yourself.
Make sure that the connection works
- Ask Claude to call
whoami. - Ask Claude to call
list-templates. - If a call fails, read the
error.codeanderror.fixfields. Read MCP server.