Shipbook について
Shipbook MCP は Shipbook のログと Loglytics のエラー分析を AI コーディングアシスタントに接続し、本番環境の問題調査を支援します。検索可能なログにはユーザー、デバイス、セッション、コード位置などの情報が含まれます。
主な機能
- 01アプリログの検索と絞り込み
- 02分類済みエラーと発生回数の取得
- 03ログのユーザー・デバイス情報の確認
- 04アプリ作成と認証情報の取得
- 05組み込みワークフローによるセッション・ログ調査
活用シーン
- 01本番環境で頻発するクラッシュの調査
- 02ユーザーセッションを追跡して経緯を把握
- 03重大度や時間によるログ検索
- 04個人情報や不適切なログレベルの監査
MCP 対応
Shipbook はアプリ管理、ログ検索、Loglytics エラー照会のツールをリモート MCP サーバーとして提供します。OAuth 2.1 認証を使用し、API キーにも対応しています。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://api.shipbook.io/mcpclaude mcp add --transport http io-shipbook https://api.shipbook.io/mcp{"mcpServers":{"io-shipbook":{"type":"http","url":"https://api.shipbook.io/mcp"}}}Cursor で開く{"servers":{"io-shipbook":{"type":"http","url":"https://api.shipbook.io/mcp"}}}VS Code で開く{"mcpServers":{"io-shipbook":{"type":"http","url":"https://api.shipbook.io/mcp"}}}{"mcpServers":{"io-shipbook":{"serverUrl":"https://api.shipbook.io/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
Shipbook MCP
Shipbook を任意の AI コーディングアシスタントに接続して、実際のアプリケーションログを使って問題を調査できます。Shipbook の Loglytics エンジンはエラーを自動的に分類し、構造化された分析情報を提供します。また、強力なログ検索機能により、AI エージェントは実行時のイベントを調査できます。ログには、重要度、ユーザー、デバイス、セッション、正確なファイルとコードの位置など、豊富なコンテキストが含まれており、アシスタントが効果的にデバッグするために必要な確かな情報を得られます。
前提条件: Shipbook アカウント。こちらから利用を開始できます。
対応プラットフォーム
MCP 対応のあらゆる AI アシスタントで動作します。
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」を検索し、Install をクリックします。
ワンクリックインストール:
手動設定: Cursor Settings → Tools & MCP → Add MCP server を開きます。
{
"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
- claude.ai → Settings → Connectors に移動します
- Add Connector をクリックして、
https://api.shipbook.io/mcpを入力します - Connect をクリックします。Shipbook にリダイレクトされ、アクセスを許可するよう求められます
VS Code (Copilot)
ワンクリックインストール:
手動: Command Palette → MCP: Add Server → 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 ストア → Manage MCP Servers → View raw config を開き、追加します。
{
"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] のユーザーに何が起きましたか?」
- 「過去 1 時間の重大度が Error のログを表示して」
- 「iOS アプリで最もよく発生するクラッシュを調査して」
- 「ユーザー X が問題を報告したセッションをデバッグして」
- 「Shipbook Loglytics で見つかった問題を修正して」
ドキュメント
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。