{
  "markdown": "# Shipbook MCP\n\nConnect [Shipbook](https://shipbook.io) to any AI coding assistant to investigate issues using real application logs. Shipbook's Loglytics engine automatically classifies errors and provides structured insights, while powerful log search lets AI agents explore runtime events. Logs include rich context — severity, user, device, session, and the exact file and code location — giving your assistant the ground truth it needs to debug effectively.\n\n**Prerequisites:** A [Shipbook](https://shipbook.io) account. [Get started here](https://www.shipbook.io/docs).\n\n## Supported Platforms\n\nWorks with any MCP-compatible AI assistant:\n\n- [Cursor](#cursor)\n- [Claude Code](#claude-code)\n- [Claude.ai](#claudeai)\n- [VS Code (Copilot)](#vs-code-copilot)\n- [Codex](#codex)\n- [Google Antigravity](#google-antigravity)\n- [Windsurf](#windsurf)\n- [Generic MCP Client](#generic-mcp-client)\n\n## MCP Tools\n\n| Tool | Description |\n|------|-------------|\n| **get-account-apps** | List all apps in your account (name, appId, platform, key, integration) |\n| **create-app** | Create a new app and get its credentials (name, appId, key) |\n| **get-loglytics-errors** | Retrieve grouped/classified errors with occurrence counts |\n| **get-logs** | Search logs with 20+ filters (severity, user, device, time, etc.) |\n\n## AI Skills\n\nPre-built investigation and integration workflows (available in Cursor and Claude Code):\n\n| Skill | Description |\n|-------|-------------|\n| **install-shipbook** | Full SDK integration assistant — installs package, detects wrappers, sets log levels, integrates Crashlytics, adds API logging, audits for PII |\n| **audit-logs** | Scan codebase for PII in logs, incorrect log levels, and sensitive data leaks |\n| **list-issues** | List and analyze classified errors/warnings from Loglytics, group by root cause |\n| **debug-session** | Trace a user's session to understand what happened |\n| **search-logs** | Search logs using natural language queries |\n\n## Installation\n\n### Cursor\n\n**From Cursor Marketplace:**\nSearch for \"Shipbook\" in the Cursor marketplace and click Install.\n\n**One-Click Install:**\n\n<a href=\"cursor://anysphere.cursor-deeplink/mcp/install?name=shipbook&config=eyJ1cmwiOiJodHRwczovL2FwaS5zaGlwYm9vay5pby9tY3AiLCJhdXRoIjp7IkNMSUVOVF9JRCI6ImExZGI4ZGY1LWNlYjUtNDAxMy04YzM1LWFmOWU0NTdjNjliNSJ9fQ\">\n  <img src=\"https://cursor.com/deeplink/mcp-install-dark.svg\" alt=\"Install Shipbook MCP in Cursor\" height=\"32\" />\n</a>\n\n**Manual Configuration:**\nOpen Cursor Settings → Tools & MCP → Add MCP server:\n```json\n{\n  \"mcpServers\": {\n    \"shipbook\": {\n      \"url\": \"https://api.shipbook.io/mcp\",\n      \"auth\": {\n        \"CLIENT_ID\": \"a1db8df5-ceb5-4013-8c35-af9e457c69b5\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```terminal\nclaude mcp add --transport http shipbook-mcp https://api.shipbook.io/mcp\n```\n\nOn first use, Claude Code opens your browser to log in and authorize access.\n\n### Claude.ai\n\n1. Go to [claude.ai](https://claude.ai) → **Settings** → **Connectors**\n2. Click **Add Connector** and enter: `https://api.shipbook.io/mcp`\n3. Click **Connect** — you'll be redirected to Shipbook to authorize access\n\n### VS Code (Copilot)\n\n**One-Click Install:**\n\n<a href=\"vscode:mcp/install?%7B%22name%22%3A%22shipbook%22%2C%22config%22%3A%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A//api.shipbook.io/mcp%22%7D%7D\">\n  <img src=\"https://img.shields.io/badge/Install_MCP_Server-VS_Code-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white\" alt=\"Install Shipbook MCP in VS Code\" height=\"32\" />\n</a>\n\n**Manual:** Open Command Palette → MCP: Add Server → HTTP → `https://api.shipbook.io/mcp`\n\n### Codex\n\nAdd to `~/.codex/config.toml`:\n```toml\n[mcp_servers.shipbook]\nurl = \"https://api.shipbook.io/mcp\"\n```\n\nThen: `codex mcp login shipbook`\n\n### Google Antigravity\n\nOpen MCP store → Manage MCP Servers → View raw config → Add:\n```json\n{\n  \"mcpServers\": {\n    \"shipbook\": {\n      \"url\": \"https://api.shipbook.io/mcp\"\n    }\n  }\n}\n```\n\n### Windsurf\n\nAdd to `~/.codeium/windsurf/mcp_config.json`:\n```json\n{\n  \"mcpServers\": {\n    \"shipbook\": {\n      \"url\": \"https://api.shipbook.io/mcp\"\n    }\n  }\n}\n```\n\n### Generic MCP Client\n\nMCP endpoint: `https://api.shipbook.io/mcp`\n\nStandard `mcpServers` configuration:\n```json\n{\n  \"mcpServers\": {\n    \"shipbook\": {\n      \"url\": \"https://api.shipbook.io/mcp\"\n    }\n  }\n}\n```\n\n## Authentication\n\nShipbook MCP uses **OAuth 2.1** for secure authentication. On first use, you'll be redirected to Shipbook to log in and authorize access. Your credentials are never shared with the AI assistant.\n\nFor MCP clients that don't support OAuth, you can use an API key from the [Authentication Keys](https://www.shipbook.io/docs/account_preferences/authentication-keys) section in the Shipbook console:\n```json\n{\n  \"mcpServers\": {\n    \"shipbook\": {\n      \"url\": \"https://api.shipbook.io/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_AUTH_TOKEN\"\n      }\n    }\n  }\n}\n```\n\n## Usage Examples\n\n- \"Install Shipbook in my project\"\n- \"Audit my logs for PII and incorrect log levels\"\n- \"Find errors in my app and suggest fixes\"\n- \"What happened to the user with email test@example.com?\"\n- \"Show me logs from the last hour with severity Error\"\n- \"Investigate the most common crash in my iOS app\"\n- \"Debug the session where user X reported a problem\"\n- \"Fix the issues found in Shipbook Loglytics\"\n\n## Documentation\n\n- [Shipbook MCP Documentation](https://www.shipbook.io/docs/mcp)\n- [Shipbook Website](https://shipbook.io)\n\n## License\n\nMIT\n",
  "bytes": 5503,
  "sha": "fc4e6090d1b39a7acf8a94461614a84cbaf8e2145c1bdf71f9c3eb1e04d1c633",
  "repo_slug": "shipbook/shipbook-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_shipbook_shipbook_mcp_shipbook_mcp_af4163d5/readme"
}