# Shipbook

Shipbook streams runtime logs and Loglytics error reports into AI assistants. It helps investigate production crashes and examine user sessions directly in your editor.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1 repo stars
- Author: ShipBook
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ShipBook/shipbook-mcp
- Updated: 2026-04-16
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/shipbook

## What it does

This MCP server links coding agents to telemetry collected by Shipbook. It exposes tools like `get-logs`, `get-loglytics-errors`, `get-account-apps`, and `create-app`. Agents inspect events across severity levels, devices, files, or specific users to trace unexpected behavior.

Cursor and Claude Code support built-in skills. They audit codebases for PII leaks and guide SDK setup. Without an active Shipbook account, no logs can be fetched. Authentication relies on OAuth 2.1 or Bearer tokens from the web console.

## Requirements
- Remote server: `https://api.shipbook.io/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://api.shipbook.io/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add shipbook --url https://api.shipbook.io/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "shipbook": {
            "url": "https://api.shipbook.io/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "shipbook": {
            "type": "http",
            "url": "https://api.shipbook.io/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http shipbook https://api.shipbook.io/mcp
```

## When to use it
- trace crash logs for a specific user session
- scan project code for sensitive data leaks in logs
- categorize Loglytics error reports by root cause
- set up the Shipbook SDK inside an application

## Example prompts
- Check Shipbook for error logs recorded during the past hour
- Scan our source files for accidental PII logging
- Trace what happened during the session for user test@example.com

## Similar
- [Honeybadger](https://affpapa.org/en/nevibecode/mcp/honeybadger.md) — MCP server · ★ 25 repo stars
- [convex-sentinel](https://affpapa.org/en/nevibecode/skills/convex-sentinel.md) — skill · 43700 installs
- [debug](https://affpapa.org/en/nevibecode/skills/debug.md) — skill · 6100 installs
- [firebase-crashlytics](https://affpapa.org/en/nevibecode/skills/ivanna-kacevica-firebase-crashlytics.md) — skill · ★ 674 repo stars
- [sentry-debug-issue](https://affpapa.org/en/nevibecode/skills/sentry-debug-issue.md) — skill · 2200 installs
- [cli-anything-nslogger](https://affpapa.org/en/nevibecode/skills/cli-anything-nslogger.md) — skill · 394 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
