Shippy MCP Server

resmi

Gemi çalışması. Telif kazanın.

shippy.sh üzerinde görüntüle

Dokümantasyon

MCP Sunucu Kurulumu

Shippy, yapay zeka kodlama asistanlarının doğrudan IDE'niz içinde ödüllerinizle etkileşime girmesini sağlayan uzak bir Model Bağlam Protokolü (MCP) sunucusu sunar.

Dokümantasyon MCP Sunucusu

Shippy dokümantasyonunu MCP aracılığıyla okumak için ayrı bir MCP uç noktası da sağladığımızı unutmayın:

Uç Nokta: https://shippy.sh/mcp/docs

Bu uç nokta kimlik doğrulama gerektirmez ve iki araç sunar:

AraçAçıklama
list_docsMevcut tüm dokümantasyon sayfalarını listele
read_docBelirli bir dokümantasyon sayfasını ID ile oku

Bu, yapay zeka asistanınızın IDE'nizden ayrılmadan Shippy dokümanlarına başvurabilmesini istiyorsanız kullanışlıdır.

Özellikler

Shippy MCP sunucusu ile yapay zeka asistanınız şunları yapabilir:

Katkıda Bulunanlar için:

  • Projeler arasında ödüllere göz atma ve arama
  • Tam ödül ayrıntılarını ve kabul kriterlerini okuma
  • Çalışmaya başlamak için ödülleri talep etme
  • İnceleme için tamamlanmış işi gönderme
  • Aktif taleplerinizi görüntüleme ve yönetme

Kurucular için:

  • Ödül oluşturma ve güncelleme
  • Ödülleri kapatma ve yeniden açma
  • Proje etiketlerini yönetme
  • Proje oluşturma ve yapılandırma (İtibar Modu veya Kâr Paylaşım Modu)

Ön Koşullar

  1. Bir Shippy hesabı (buradan kaydolun)
  2. Bir MCP erişim belirteci (Kullanıcı Ayarları → MCP Erişim Belirteçleri'nden bir tane oluşturun)

Hızlı Kurulum (Cursor)

Cursor kullanıyorsanız, bir belirteç oluşturduktan sonra kullanıcı ayarlarınızdaki "Cursor'a Ekle" düğmesine tıklayın. Bu, MCP sunucusunu otomatik olarak yapılandıracaktır.

Manuel Kurulum

Cursor

Bunu ~/.cursor/mcp.json dosyasına ekleyin:

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

Windsurf

Bunu ~/.codeium/windsurf/mcp_config.json dosyasına ekleyin:

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

Not: Windsurf, HTTP sunucuları için url yerine serverUrl kullanır. Windsurf MCP dokümanlarına bakın.

Codex (OpenAI)

Codex, ~/.codex/config.toml içinde TOML yapılandırması kullanır. İki seçeneğiniz var:

Seçenek 1: Doğrudan belirteç (daha basit)

Bunu ~/.codex/config.toml dosyasına ekleyin:

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

Seçenek 2: Ortam değişkeni (daha güvenli)

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

Ardından kabuğunuzda ortam değişkenini ayarlayın (~/.zshrc veya ~/.bashrc dosyasına ekleyin):

export SHIPPY_MCP_TOKEN="shp_YOUR_TOKEN"

Not: Daha fazla yapılandırma seçeneği için Codex MCP dokümantasyonuna bakın.

Claude Desktop

Claude Desktop yalnızca stdio tabanlı MCP sunucularını destekler, bu nedenle Shippy'nin HTTP uç noktasına bağlanmak için mcp-remote'a ihtiyacınız olacak.

Claude Desktop yapılandırmanıza ekleyin:

  • 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 da stdio tabanlı sunucular kullanır. Shippy'yi CLI aracılığıyla ekleyebilirsiniz:

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

Veya projenizin .mcp.json dosyasına ekleyin:


### 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


## Güvenlik

* MCP belirteciniz Shippy hesabınıza bağlıdır
* Belirteçler ayarlarınızdan istediğiniz zaman iptal edilebilir
* Her belirteç, denetim için en son ne zaman kullanıldığını gösterir
* Farklı makineler için ayrı belirteçler kullanmanızı öneririz
* `shp_` belirteç öneki, GitHub gizli taramasını etkinleştirir

## Kaynaklar

* Model Bağlam Protokolü Spesifikasyonu
* Cursor MCP Dokümantasyonu
* Windsurf MCP Dokümantasyonu
* Claude Desktop MCP Kılavuzu
* npm'de mcp-remote

## Yardıma mı İhtiyacınız Var?

[email protected] adresine e-posta gönderin