Skip to main content

MCP (Model Context Protocol)

MCP (Model Context Protocol)​

Shipbook supports MCP (Model Context Protocol) for programmatic access to logs and error data.

The MCP endpoint is available at: https://api.shipbook.io/mcp

To authenticate with the MCP API, you can get a token from the authentication keys section in the console. For more information on how to create and manage authentication keys, see Authentication Keys.

Configuring MCP with AI Assistants​

Cursor​

To configure Shipbook MCP in Cursor:

  1. Open Cursor Settings (Cmd/Ctrl + ,)
  2. Navigate to "Tools & MCP" → "Add MCP server" or search for "MCP"
  3. Add a new MCP server with the following configuration:
{
  "mcpServers": {
    "shipbook-mcp": {
      "url": "https://api.shipbook.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_AUTH_TOKEN"
      }      
    }
  }
}

Replace YOUR_AUTH_TOKEN with your authentication token from the console.

In reality it is saving the information Here at .cursor/mcp.json:

Claude Desktop​

To configure Shipbook MCP in Claude Desktop:

  1. Open the Claude Desktop configuration file:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: C:\Users\<YourUsername>\AppData\Roaming\Claude\claude_desktop_config.json

  2. Add the Shipbook MCP server configuration:

claude mcp add --transport http shipbook-mcp https://api.shipbook.io/mcp \
  --header "Authorization: Bearer YOUR_AUTH_TOKEN"

Replace YOUR_AUTH_TOKEN with your authentication token from the console.

For more information view https://code.claude.com/docs/en/mcp#option-1:-add-a-remote-http-server

Example Questions​

Once configured, you can interact with the AI assistant to query your Shipbook logs and errors. The assistant will use the Shipbook MCP tools to access your data directly and can even help fix issues in your code when applicable.

Example queries:

  • "Find logs for email [email protected] and fix any code issues if found"
  • "Fix the issues found in Shipbook Loglytics"

The AI assistant leverages Shipbook MCP tools to query your logs and error data in real-time, providing insights into your application's behavior and issues. When applicable, it can also analyze the code and suggest fixes for problems identified in the logs.