Ship It Squirrel MCP Server

Connect Claude Code to your Ship It Squirrel apps to deploy, monitor, debug, and fix your Rails apps from the terminal.

Installation

1. Get your API Token

1. Go to shipitsquirrel.com/settings/api
2. Create a new API token
3. Copy the token

2. Add to Claude Code

The easiest way is to use the CLI:

claude mcp add -e "SHIPITSQUIRREL_API_TOKEN=your-api-token-here" -s user shipitsquirrel -- npx -y @shipitsquirrel/mcp-server

Or manually add this to your ~/.claude.json file:

{
  "mcpServers": {
    "shipitsquirrel": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@shipitsquirrel/mcp-server"],
      "env": {
        "SHIPITSQUIRREL_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

3. Restart Claude Code

Restart Claude Code to load the new MCP server. Verify it's connected with /mcp.

Available Tools

Servers

| Tool | Description | |------|-------------| | list_servers | List all your servers with IPs and status | | get_server | Get detailed server info including apps |

Apps

| Tool | Description | |------|-------------| | list_apps | List all your apps with status and bug counts | | get_app | Get detailed info about a specific app |

Deployments & Operations

| Tool | Description | |------|-------------| | list_deployments | List recent deployments for an app | | get_deployment | Get deployment details including full log | | deploy_app | Trigger a new deployment | | restart_app | Restart the application (Puma) | | rollback_app | Rollback to previous successful deployment | | get_app_logs | Get recent application logs from the server |

Bug Tracking

| Tool | Description | |------|-------------| | list_bugs | List bugs for an app (filter by status) | | get_bug | Get full bug details including backtrace | | resolve_bug | Mark a bug as resolved | | ignore_bug | Mark a bug as ignored | | reopen_bug | Reopen a resolved/ignored bug |

Example Usage

Once connected, you can ask Claude things like:

• "List my Ship It Squirrel servers"
• "Show me open bugs for my-app"
• "Get details on bug abc123 and fix the code"
• "Deploy my-app"
• "Show me the last 200 lines of logs for my-app"
• "Rollback my-app to the previous version"
• "Restart my-app"
• "Resolve bug xyz789 with notes 'Fixed in commit abc'"

Full Bug Fix Workflow

Claude can handle the entire cycle: see a bug, read the backtrace, find the relevant code, fix it, deploy the fix, then mark the bug as resolved.

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | SHIPITSQUIRREL_API_TOKEN | Yes | Your API token from shipitsquirrel.com | | SHIPITSQUIRREL_URL | No | API base URL (default: https://shipitsquirrel.com) |

Development

npm install
SHIPITSQUIRREL_API_TOKEN=your-token npm start

License

MIT