Shipbook

io.shipbook由 shipbook.io 发布官方发布者v1.1.0更新于 Oct 24, 2026

Debug production issues using Shipbook logs and Loglytics error insights.

已验证Streamable HTTP可网页运行开发者工具安全与监控

概览

AI 生成的概览

Shipbook 的远程 MCP 服务器让 AI 助手搜索应用日志、查看已分类的错误，并借助真实运行时数据排查生产问题。

可以做什么
列出账户内的应用，并创建新应用及其凭据（名称、appId、key）。从 Loglytics 引擎获取按组分类的错误及出现次数。使用严重级别、用户、设备、时间等 20 多个筛选条件搜索日志。追踪用户会话，了解特定用户经历了什么。内置技能可协助安装 SDK、审计日志中的个人隐私数据和错误日志级别，并按根本原因归类问题。
适用场景
适合在排查移动端或网页应用的生产问题、崩溃时使用，让助手基于真实日志和错误分类工作，而不是靠猜测。也适合希望协助集成 Shipbook SDK 或审计现有日志中敏感数据的团队。
运行要求
远程 MCP 端点 api.shipbook.io/mcp，使用 streamable HTTP。需要 Shipbook 账户。认证采用 OAuth 2.1，首次使用时通过浏览器登录并授权；不支持 OAuth 的客户端可使用 Shipbook 控制台生成的 API 密钥，以 Authorization Bearer 请求头发送。
安装前请注意
该服务器可创建新应用并返回其凭据，还会读取可能包含用户、设备和会话数据（含个人信息）的生产日志。日志审计技能会扫描你的代码库。通过 OAuth 或 API 密钥可访问你的 Shipbook 账户，请将该令牌视为机密，并确认助手被允许读取或创建的内容。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Shipbook，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.shipbook%2Fmcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

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

README

Shipbook MCP

Connect Shipbook 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.

Prerequisites: A Shipbook account. Get started here.

Supported Platforms

Works with any MCP-compatible AI assistant:

MCP Tools

ToolDescription
get-account-appsList all apps in your account (name, appId, platform, key, integration)
create-appCreate a new app and get its credentials (name, appId, key)
get-loglytics-errorsRetrieve grouped/classified errors with occurrence counts
get-logsSearch logs with 20+ filters (severity, user, device, time, etc.)

AI Skills

Pre-built investigation and integration workflows (available in Cursor and Claude Code):

SkillDescription
install-shipbookFull SDK integration assistant — installs package, detects wrappers, sets log levels, integrates Crashlytics, adds API logging, audits for PII
audit-logsScan codebase for PII in logs, incorrect log levels, and sensitive data leaks
list-issuesList and analyze classified errors/warnings from Loglytics, group by root cause
debug-sessionTrace a user's session to understand what happened
search-logsSearch logs using natural language queries

Installation

Cursor

From Cursor Marketplace: Search for "Shipbook" in the Cursor marketplace and click Install.

One-Click Install:

[Install Shipbook MCP in Cursor]

Manual Configuration: Open Cursor Settings → Tools & MCP → Add MCP server:

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

Claude Code

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

On first use, Claude Code opens your browser to log in and authorize access.

Claude.ai

  1. Go to claude.ai → Settings → Connectors
  2. Click Add Connector and enter: https://api.shipbook.io/mcp
  3. Click Connect — you'll be redirected to Shipbook to authorize access

VS Code (Copilot)

One-Click Install:

[Install Shipbook MCP in VS Code]

Manual: Open Command Palette → MCP: Add Server → HTTP → https://api.shipbook.io/mcp

Codex

Add to ~/.codex/config.toml:

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

Then: codex mcp login shipbook

Google Antigravity

Open MCP store → Manage MCP Servers → View raw config → Add:

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

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

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

Generic MCP Client

MCP endpoint: https://api.shipbook.io/mcp

Standard mcpServers configuration:

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

Authentication

Shipbook 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.

For MCP clients that don't support OAuth, you can use an API key from the Authentication Keys section in the Shipbook console:

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

Usage Examples

  • "Install Shipbook in my project"
  • "Audit my logs for PII and incorrect log levels"
  • "Find errors in my app and suggest fixes"
  • "What happened to the user with email [email protected]?"
  • "Show me logs from the last hour with severity Error"
  • "Investigate the most common crash in my iOS app"
  • "Debug the session where user X reported a problem"
  • "Fix the issues found in Shipbook Loglytics"

Documentation

License

MIT

来源：README.md，提交 788a220

工具

0
该服务器需要登录，因此 SourceWeft 无法在没有账号的情况下读取其工具，也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

1
  1. v1.1.0最新Sep 16, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分