Claude Code + Snipara

Claude Code is Anthropic's official CLI for Claude with native MCP support. This guide covers the Hosted MCP path for giving Claude Code a Project Brain before it edits.

What changes inside Claude Code?

Implement OAuth.

Claude starts searching,
reconstructing architecture,
and asking for old context.

Opening Work Brief...

OK Decisions
OK Active work
OK Architecture
OK Impact
OK Verification

Ready.

Why Claude Code users install Snipara

• Stop re-explaining the project.
• Reuse reviewed decisions.
• Know code impact before editing.
• Start every session with a Work Brief.

Native lifecycle integration

Claude Code can combine Hosted MCP with project guidance in CLAUDE.md and AGENTS.md. Use hook bundles only where the page or generated setup explicitly installs verified Claude Code hooks; Hosted MCP remains the normal agent path.

What You Get

Quick Setup (One Command)

The fastest manual HTTP path is using the claude mcp add command:

claude mcp add --scope project --transport http my-project "https://api.snipara.com/mcp/YOUR_PROJECT_SLUG" --header "X-API-Key: YOUR_API_KEY"

Replace the placeholders:

• my-project - A name for this MCP server (use your project slug)
• YOUR_PROJECT_SLUG - Your project slug from the Snipara dashboard
• YOUR_API_KEY - Your Snipara API key with access to this project

Manual Configuration

For more control, you can manually commit a project-scoped MCP config at .mcp.json:

{
  "mcpServers": {
    "my-project": {
      "type": "http",
      "url": "https://api.snipara.com/mcp/YOUR_PROJECT_SLUG",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Verify Installation

After adding the server, verify it's configured correctly:

claude mcp list

my-project (http) - https://api.snipara.com/mcp/YOUR_PROJECT_SLUG

Test the connection:

claude mcp test my-project

✓ Connection successful (45ms)

✓ 128 tools available

Using Snipara Tools

Once connected, Claude Code will automatically use Snipara tools when appropriate. You can also explicitly request them:

claude

Use snipara_ask to find how authentication works in this project

[Calling snipara_ask with question="How does authentication work?"]

Based on the documentation, authentication uses JWT tokens...

Available MCP Tools

Snipara provides 128 MCP tools. Here are the ones most commonly used in Claude Code:

See the MCP Tools Reference for complete documentation of the full 128-tool contract.

Multiple Projects

You can connect multiple Snipara projects to Claude Code:

claude mcp add --scope project --transport http frontend-docs ".../mcp/proj1" --header "..."

claude mcp add --scope project --transport http backend-docs ".../mcp/proj2" --header "..."

claude mcp add --scope project --transport http api-specs ".../mcp/proj3" --header "..."

Claude Code will intelligently route questions to the appropriate project based on context.

Using Environment Variables

For the direct HTTP path, store your API key in an environment variable:

~/.zshrc or ~/.bashrc

export SNIPARA_API_KEY="snp-your-api-key"

Then reference it in your configuration:

claude mcp add --scope project --transport http my-project "https://api.snipara.com/mcp/PROJECT_SLUG" --header "X-API-Key: $SNIPARA_API_KEY"

Troubleshooting

Next Steps