Shippy MCP Server

offiziell

Schiffsarbeit. Verdiene Lizenzgebühren.

Auf shippy.sh ansehen

Dokumentation

MCP-Server-Installation

Shippy bietet einen entfernten Model Context Protocol (MCP)-Server, der es KI-Coding-Assistenten ermöglicht, direkt in Ihrer IDE mit Ihren Bounties zu interagieren.

Dokumentations-MCP-Server

Beachten Sie, dass wir auch einen separaten MCP-Endpunkt zum Lesen der Shippy-Dokumentation über MCP bereitstellen:

Endpunkt: https://shippy.sh/mcp/docs

Dieser Endpunkt erfordert keine Authentifizierung und bietet zwei Werkzeuge:

WerkzeugBeschreibung
list_docsAlle verfügbaren Dokumentationsseiten auflisten
read_docEine bestimmte Dokumentationsseite anhand der ID lesen

Dies ist nützlich, wenn Ihr KI-Assistent auf Shippy-Dokumente verweisen soll, ohne Ihre IDE zu verlassen.

Funktionen

Mit dem Shippy MCP-Server kann Ihr KI-Assistent:

Für Mitwirkende:

  • Bounties projektübergreifend durchsuchen und durchstöbern
  • Vollständige Bounty-Details und Abnahmekriterien lesen
  • Bounties beanspruchen, um mit der Arbeit zu beginnen
  • Abgeschlossene Arbeiten zur Überprüfung einreichen
  • Ihre aktiven Beanspruchungen einsehen und verwalten

Für Gründer:

  • Bounties erstellen und aktualisieren
  • Bounties schließen und wieder öffnen
  • Projekt-Labels verwalten
  • Projekte erstellen und konfigurieren (Reputationsmodus oder Gewinnbeteiligungsmodus)

Voraussetzungen

  1. Ein Shippy-Konto (hier anmelden)
  2. Ein MCP-Zugriffstoken (generieren Sie eines in Ihren Benutzereinstellungen → MCP-Zugriffstoken)

Schnellinstallation (Cursor)

Wenn Sie Cursor verwenden, klicken Sie nach der Token-Generierung in Ihren Benutzereinstellungen auf die Schaltfläche „Zu Cursor hinzufügen“. Dadurch wird der MCP-Server automatisch konfiguriert.

Manuelle Installation

Cursor

Fügen Sie dies zu ~/.cursor/mcp.json hinzu:

{
  "mcpServers": {
    "shippy": {
      "url": "https://shippy.sh/mcp",
      "headers": {
        "Authorization": "Bearer shp_YOUR_TOKEN"
      }
    }
  }
}

Windsurf

Fügen Sie dies zu ~/.codeium/windsurf/mcp_config.json hinzu:

{
  "mcpServers": {
    "shippy": {
      "serverUrl": "https://shippy.sh/mcp",
      "headers": {
        "Authorization": "Bearer shp_YOUR_TOKEN"
      }
    }
  }
}

Hinweis: Windsurf verwendet serverUrl anstelle von url für HTTP-Server. Siehe die Windsurf MCP-Dokumentation.

Codex (OpenAI)

Codex verwendet TOML-Konfiguration in ~/.codex/config.toml. Sie haben zwei Möglichkeiten:

Option 1: Direktes Token (einfacher)

Fügen Sie dies zu ~/.codex/config.toml hinzu:

[mcp_servers.shippy]
url = "https://shippy.sh/mcp"
http_headers = { "Authorization" = "Bearer shp_YOUR_TOKEN" }

Option 2: Umgebungsvariable (sicherer)

[mcp_servers.shippy]
url = "https://shippy.sh/mcp"
bearer_token_env_var = "SHIPPY_MCP_TOKEN"

Setzen Sie dann die Umgebungsvariable in Ihrer Shell (zu ~/.zshrc oder ~/.bashrc hinzufügen):

export SHIPPY_MCP_TOKEN="shp_YOUR_TOKEN"

Hinweis: Weitere Konfigurationsoptionen finden Sie in der Codex MCP-Dokumentation.

Claude Desktop

Claude Desktop unterstützt nur stdio-basierte MCP-Server, daher benötigen Sie mcp-remote, um eine Verbindung zum HTTP-Endpunkt von Shippy herzustellen.

Zur Claude Desktop-Konfiguration hinzufügen:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "shippy": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://shippy.sh/mcp",
        "--header",
        "Authorization: Bearer shp_YOUR_TOKEN"
      ]
    }
  }
}

Claude Code

Claude Code verwendet ebenfalls stdio-basierte Server. Sie können Shippy über die CLI hinzufügen:

claude mcp add shippy -- npx -y mcp-remote https://shippy.sh/mcp --header "Authorization: Bearer shp_YOUR_TOKEN"

Oder fügen Sie es zur .mcp.json Ihres Projekts hinzu:


### Other Clients (stdio-only)

For other MCP clients that only support stdio transport (not Streamable HTTP), use mcp-remote with the same configuration pattern as Claude Desktop above.

> Note: Cursor 0.50+ and Windsurf support Streamable HTTP natively. Claude Desktop, Claude Code, and older clients require mcp-remote.

## Available Tools

### Read Operations

| Tool                  | Description                                           | Auth       |
| --------------------- | ----------------------------------------------------- | ---------- |
| list\_projects        | Browse projects on Shippy                             | Optional\* |
| read\_project         | Get project details by slug                           | Optional\* |
| list\_bounties        | List bounties for a project                           | Optional\* |
| read\_bounty          | Get bounty by identifier (e.g., "SHP-42")             | Optional\* |
| list\_labels          | List all labels for a project                         | Optional\* |
| read\_label           | Get label details by ID                               | Optional\* |
| list\_comments        | List comments on a bounty                             | Optional\* |
| list\_attachments     | List attachments for a bounty, submission, or comment | Optional\* |
| list\_my\_bounties    | List bounties you have claimed                        | Required   |
| list\_my\_submissions | List your submissions                                 | Required   |

\*Optional: Works without auth for public projects. With auth, also shows your private projects.

### Contributor Operations

| Tool                           | Description                                      |
| ------------------------------ | ------------------------------------------------ |
| claim\_bounty                  | Claim a bounty to start working on it            |
| release\_claim                 | Release your claim on a bounty                   |
| create\_submission             | Submit work for a claimed bounty                 |
| update\_submission             | Update a draft/pending submission                |
| suggest\_bounty                | Suggest a new bounty for founder review          |
| create\_comment                | Add a comment to a bounty (supports attachments) |
| update\_comment                | Update your own comment                          |
| delete\_comment                | Delete a comment (author or founder)             |
| get\_contributor\_agreement    | View project's contributor agreement             |
| accept\_contributor\_agreement | Accept project's contributor agreement           |

### Attachment Operations

| Tool                         | Description                                        |
| ---------------------------- | -------------------------------------------------- |
| generate\_nanoid             | Generate a unique ID for pre-uploading attachments |
| get\_attachment\_upload\_url | Get a signed URL to upload a file to R2            |
| create\_attachment           | Register an uploaded attachment                    |
| delete\_attachment           | Delete an attachment                               |

Attachments can be added to bounties, submissions, and comments. For comments, use the `PENDING_COMMENT` reference type when uploading before the comment exists, then pass the generated ID to `create_comment`.

### Founder Operations

| Tool                  | Description                                            |
| --------------------- | ------------------------------------------------------ |
| create\_bounty        | Create a new bounty for a project                      |
| update\_bounty        | Update bounty title, description, points, etc.         |
| close\_bounty         | Close a bounty (expires claims)                        |
| reopen\_bounty        | Reopen a closed bounty                                 |
| create\_label         | Create a new label for a project                       |
| update\_label         | Update label name or color                             |
| delete\_label         | Delete a label from a project                          |
| create\_project       | Create a new project (reputation or profit share mode) |
| update\_project       | Update project settings                                |
| update\_project\_logo | Update or remove project logo                          |

## Example Usage

Once connected, try prompts like:

> "What bounties am I working on?"

> "Show me bounty SHP-42"

> "List open bounties on the shippy project"

> "Claim bounty SHP-15"

> "Submit my work for SHP-15 with description: Implemented the dark mode toggle. See PR #42."

> "Update submission sub\_123 with description: Added screenshots and test results."

> "Update submission sub\_123 to status: PENDING"

> "Add a comment on SHP-42: Great work! Here's my feedback..."

> "Upload a screenshot to my comment on SHP-42"

For Founders:

> "Create a bounty for my project 'shippy' titled 'Add dark mode support' with 50 points"

> "Update SHP-42 to have 100 points"

> "Create a label called 'urgent' with color #FF0000 for my shippy project"

> "Create a reputation mode project called 'my-oss-project' for open source contributions"

> "Create a profit share project with 10% pool percentage and monthly payouts"

## Troubleshooting

### Server not connecting

1. Verify your token is correct and hasn't been deleted
2. Make sure you're using the correct config file path for your IDE
3. Restart your IDE after making config changes
4. Check that Shippy is accessible at https://shippy.sh/mcp

### Authentication errors

1. Check that your token starts with `shp_`
2. Ensure the `Authorization` header format is `Bearer shp_YOUR_TOKEN` (with a space)
3. Generate a new token if the current one isn't working

### Tools not appearing

1. Make sure the MCP server is enabled in your IDE's settings
2. Check your IDE's MCP logs for connection errors
3. Try refreshing/reloading the MCP server list

### 406 Not Acceptable errors

If you're building your own MCP client, ensure your requests include:

Accept: application/json, text/event-stream


## Sicherheit

* Ihr MCP-Token ist mit Ihrem Shippy-Konto verknüpft
* Token können jederzeit in Ihren Einstellungen widerrufen werden
* Jedes Token zeigt an, wann es zuletzt verwendet wurde, zur Nachverfolgung
* Wir empfehlen, für verschiedene Rechner separate Token zu verwenden
* Das Token-Präfix `shp_` ermöglicht das Scannen von GitHub-Geheimnissen

## Ressourcen

* Model Context Protocol-Spezifikation
* Cursor MCP-Dokumentation
* Windsurf MCP-Dokumentation
* Claude Desktop MCP-Anleitung
* mcp-remote auf npm

## Hilfe benötigt?

E-Mail an [email protected]