Skip to main content

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:

ScopeLocationUse Case
User~/.claude.jsonAvailable in all projects
Project.mcp.json in project rootProject-specific, shareable via git

Choose the configuration based on whether you have the Desktop App or VS Code Extension installed.

Desktop App​

If you have the SF Veritas Desktop App installed:

macOS​

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

Windows​

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

Linux​

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

VS Code Extension​

If you have the SF Veritas VS Code Extension installed:

macOS / Linux​

{
  "mcpServers": {
    "sailfishTelemetry": {
      "command": "bash",
      "args": ["-c", "node \"$(ls -d ~/.vscode/extensions/sailfish-ai.sf-veritas-extension-* 2>/dev/null | sort -V | tail -1)/dist/mcp-server-bundled.js\""]
    }
  }
}

This command:

  • Uses glob pattern to find the extension (no hardcoded version)
  • Sorts by version and picks the latest if multiple exist
  • Uses bash -c to handle path expansion

Windows​

{
  "mcpServers": {
    "sailfishTelemetry": {
      "command": "cmd",
      "args": ["/c", "for /d %d in (%USERPROFILE%\\.vscode\\extensions\\sailfish-ai.sf-veritas-extension-*) do @node \"%d\\dist\\mcp-server-bundled.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. Desktop App: Verify the app is installed at the expected location
  2. VS Code Extension: Ensure the extension exists: ls ~/.vscode/extensions | grep sf-veritas
  3. Check that Node.js 18+ is installed: node --version
  4. Verify the JSON syntax in your config file
  5. 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