Shipbook

Shipbook MCP

将 Shipbook 接入任意 AI 编码助手，利用真实的应用日志调查问题。Shipbook 的 Loglytics 引擎会自动分类错误并提供结构化分析，而强大的日志搜索功能可让 AI Agent 探索运行时事件。日志包含丰富的上下文信息——严重程度、用户、设备、会话，以及确切的文件和代码位置——为助手提供有效调试所需的真实依据。

**前提条件：**拥有 Shipbook 账号。在此开始使用。

支持的平台

适用于任何兼容 MCP 的 AI 助手：

• Cursor
• Claude Code
• Claude.ai
• VS Code (Copilot)
• Codex
• Google Antigravity
• Windsurf
• 通用 MCP 客户端

MCP 工具

工具	描述
get-account-apps	列出账号中的所有应用（名称、appId、平台、密钥、集成）
create-app	创建新应用并获取其凭据（名称、appId、密钥）
get-loglytics-errors	获取分组/分类后的错误及其出现次数
get-logs	使用 20 多种筛选条件搜索日志（严重程度、用户、设备、时间等）

AI 技能

预置的调查和集成工作流（可在 Cursor 和 Claude Code 中使用）：

技能	描述
install-shipbook	完整的 SDK 集成助手——安装软件包、检测封装器、设置日志级别、集成 Crashlytics、添加 API 日志记录，并检查 PII
audit-logs	扫描代码库中的日志，查找 PII、错误的日志级别和敏感数据泄漏
list-issues	列出并分析 Loglytics 分类的错误/警告，并按根本原因分组
debug-session	跟踪用户会话，了解发生了什么
search-logs	使用自然语言查询搜索日志

安装

Cursor

从 Cursor Marketplace 安装： 在 Cursor Marketplace 中搜索“Shipbook”，然后点击安装。

一键安装：

手动配置： 打开 Cursor 设置 → 工具与 MCP → 添加 MCP 服务：

{
  "mcpServers": {
    "shipbook": {
      "url": "https://api.shipbook.io/mcp",
      "auth": {
        "CLIENT_ID": "a1db8df5-ceb5-4013-8c35-af9e457c69b5"
      }
    }
  }
}

Claude Code

claude mcp add --transport http shipbook-mcp https://api.shipbook.io/mcp

首次使用时，Claude Code 会在浏览器中打开登录页面，并授权访问。

Claude.ai

1. 前往 claude.ai → 设置 → 连接器
2. 点击 添加连接器 并输入：https://api.shipbook.io/mcp
3. 点击 连接——系统会将你重定向到 Shipbook 以授权访问

VS Code (Copilot)

一键安装：

**手动安装：**打开命令面板 → MCP：添加服务 → HTTP → https://api.shipbook.io/mcp

Codex

添加到 ~/.codex/config.toml：

[mcp_servers.shipbook]
url = "https://api.shipbook.io/mcp"

然后运行：codex mcp login shipbook

Google Antigravity

打开 MCP 商店 → 管理 MCP 服务 → 查看原始配置 → 添加：

{
  "mcpServers": {
    "shipbook": {
      "url": "https://api.shipbook.io/mcp"
    }
  }
}

Windsurf

添加到 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "shipbook": {
      "url": "https://api.shipbook.io/mcp"
    }
  }
}

通用 MCP 客户端

MCP 端点：https://api.shipbook.io/mcp

标准 mcpServers 配置：

{
  "mcpServers": {
    "shipbook": {
      "url": "https://api.shipbook.io/mcp"
    }
  }
}

身份验证

Shipbook MCP 使用 OAuth 2.1 进行安全身份验证。首次使用时，系统会将你重定向至 Shipbook，以便登录并授权访问。你的凭据绝不会与 AI 助手共享。

对于不支持 OAuth 的 MCP 客户端，你可以使用 Shipbook 控制台中 身份验证密钥 部分提供的 API 密钥：

{
  "mcpServers": {
    "shipbook": {
      "url": "https://api.shipbook.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_AUTH_TOKEN"
      }
    }
  }
}

使用示例

• “在我的项目中安装 Shipbook”
• “审查我的日志，检查其中是否包含个人身份信息（PII）以及日志级别是否有误”
• “找出我的应用中的错误并建议修复方法”
• “邮箱为 [email protected] 的用户发生了什么情况？”
• “显示最近一小时严重级别为 Error 的日志”
• “调查我的 iOS 应用中最常见的崩溃”
• “调试用户 X 报告问题时的会话”
• “修复 Shipbook Loglytics 中发现的问题”

文档

• Shipbook MCP 文档
• Shipbook 网站

许可证

MIT