Shippy MCP Server

공식

작업을 배송하고 로열티를 받으세요.

shippy.sh에서 보기

문서

MCP 서버 설치

Shippy는 AI 코딩 어시스턴트가 IDE에서 직접 바운티와 상호작용할 수 있도록 원격 모델 컨텍스트 프로토콜(MCP) 서버를 제공합니다.

문서 MCP 서버

Shippy 문서를 MCP를 통해 읽을 수 있는 별도의 MCP 엔드포인트도 제공합니다:

엔드포인트: https://shippy.sh/mcp/docs

이 엔드포인트는 인증이 필요하지 않으며 두 가지 도구를 제공합니다:

도구설명
list_docs사용 가능한 모든 문서 페이지 나열
read_docID로 특정 문서 페이지 읽기

이는 AI 어시스턴트가 IDE를 떠나지 않고도 Shippy 문서를 참조할 수 있도록 하고 싶을 때 유용합니다.

기능

Shippy MCP 서버를 통해 AI 어시스턴트는 다음을 수행할 수 있습니다:

기여자용:

  • 프로젝트 전반의 바운티 탐색 및 검색
  • 전체 바운티 세부 정보 및 수락 기준 읽기
  • 작업 시작을 위한 바운티 클레임
  • 완료된 작업 제출하여 검토 요청
  • 활성 클레임 보기 및 관리

창업자용:

  • 바운티 생성 및 업데이트
  • 바운티 닫기 및 다시 열기
  • 프로젝트 라벨 관리
  • 프로젝트 생성 및 구성 (평판 모드 또는 수익 공유 모드)

사전 요구 사항

  1. Shippy 계정 (여기에서 가입)
  2. MCP 액세스 토큰 (사용자 설정 → MCP 액세스 토큰에서 생성)

빠른 설치 (Cursor)

Cursor를 사용 중이라면 토큰 생성 후 사용자 설정에서 "Cursor에 추가" 버튼을 클릭하세요. 그러면 MCP 서버가 자동으로 구성됩니다.

수동 설치

Cursor

~/.cursor/mcp.json에 다음을 추가하세요:

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

Windsurf

~/.codeium/windsurf/mcp_config.json에 다음을 추가하세요:

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

참고: Windsurf는 HTTP 서버에 url 대신 serverUrl을 사용합니다. Windsurf MCP 문서를 참조하세요.

Codex (OpenAI)

Codex는 ~/.codex/config.toml에서 TOML 구성을 사용합니다. 두 가지 옵션이 있습니다:

옵션 1: 직접 토큰 (간단함)

~/.codex/config.toml에 다음을 추가하세요:

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

옵션 2: 환경 변수 (더 안전함)

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

그런 다음 셸에서 환경 변수를 설정하세요 (~/.zshrc 또는 ~/.bashrc에 추가):

export SHIPPY_MCP_TOKEN="shp_YOUR_TOKEN"

참고: 더 많은 구성 옵션은 Codex MCP 문서를 참조하세요.

Claude Desktop

Claude Desktop은 stdio 기반 MCP 서버만 지원하므로 Shippy의 HTTP 엔드포인트에 연결하려면 mcp-remote가 필요합니다.

Claude Desktop 구성에 추가하세요:

  • 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도 stdio 기반 서버를 사용합니다. CLI를 통해 Shippy를 추가할 수 있습니다:

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

또는 프로젝트의 .mcp.json에 추가하세요:


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


## 보안

* MCP 토큰은 Shippy 계정에 연결됩니다
* 설정에서 언제든지 토큰을 취소할 수 있습니다
* 각 토큰은 감사를 위해 마지막 사용 시간을 표시합니다
* 다른 기기마다 별도의 토큰을 사용하는 것이 좋습니다
* 토큰 접두사 `shp_`은 GitHub 비밀 검사를 활성화합니다

## 리소스

* 모델 컨텍스트 프로토콜 사양
* Cursor MCP 문서
* Windsurf MCP 문서
* Claude Desktop MCP 가이드
* npm의 mcp-remote

## 도움이 필요하신가요?

[email protected]로 이메일 보내기