Claude Code

Claude Code is Anthropic's official CLI for Claude. It supports MCP servers for extending Claude's capabilities with external tools.

Configuration

Claude Code supports two configuration levels:

Scope	Location	Use Case
User	~/.claude.json	Available in all projects
Project	.mcp.json in project root	Project-specific, shareable via git

Configure the MCP server path based on your platform:

macOS

{
  "mcpServers": {
    "sailfishTelemetry": {
      "command": "node",
      "args": ["/Applications/SF Veritas.app/Contents/Resources/mcp-server/index.js"]
    }
  }
}

Windows

{
  "mcpServers": {
    "sailfishTelemetry": {
      "command": "node",
      "args": ["%LOCALAPPDATA%\\Programs\\SF Veritas\\resources\\mcp-server\\index.js"]
    }
  }
}

Linux

{
  "mcpServers": {
    "sailfishTelemetry": {
      "command": "node",
      "args": ["/opt/SF Veritas/resources/mcp-server/index.js"]
    }
  }
}

Verification

After configuring, verify the connection:

1. Open your terminal in the project directory
2. Run claude to start Claude Code
3. Type /mcp to see connected MCP servers
4. You should see sailfishTelemetry in the list

Alternatively, run /config to see the full configuration including MCP servers.

Usage

Once connected, ask Claude to use the telemetry tools:

> List my recent telemetry sessions
> Show me any errors from the last hour
> What are the slowest functions in my application?
> Analyze the performance of API calls to /api/users

Claude will automatically use the appropriate MCP tools to query your telemetry data.

Troubleshooting

Server not appearing in /mcp

1. Verify the app is installed at the expected location
2. Check that Node.js 18+ is installed: node --version
3. Verify the JSON syntax in your config file
4. Restart Claude Code

"No telemetry data found"

1. Ensure your application has been instrumented with SF Veritas SDK
2. Run your application to generate telemetry data
3. Check that the database exists: ls ~/.sailfish/telemetry.db