railguey-mcp-cloudflare

Railguey 클라우드에서. Grok을 Railway GraphQL에 연결하는 Cloudflare Worker MCP 서버입니다.

CLI는 eidos-agi/railguey에 있습니다. 이 저장소는 Grok이 실제로 커넥터로 추가할 수 있는 호스팅된 Streamable HTTP MCP입니다. Railway 자체 MCP(mcp.railway.com)는 OAuth/CLI 형태이므로 Grok에 직접 추가할 수 없습니다.

라이브 Worker: railguey.eidos-agi.workers.dev

MCP: https://railguey.eidos-agi.workers.dev/mcp

제품 페이지: eidosagi.com/tools/railguey

별도 저장소를 두는 이유

Worker 스크립트는 Cloudflare에서 여전히 railguey라는 이름을 사용합니다. 이 이름은 workers.dev 호스트이며 wrangler.toml의 name과 일치해야 합니다. GitHub 저장소 이름은 그 역할에 따라 지어졌습니다.

Related MCP server: @crisog/railway-mcp-server

페어링 (클레임 코드)

Railway 토큰은 Grok 채팅을 거치지 않습니다. 페어링은 기기 코드 흐름입니다:

1. Grok이 account_pair_begin을 호출합니다(또는 여기에서 코드가 발급됩니다).

2. 이 Worker에서 /pair/<CODE>를 엽니다.

3. Railway 토큰을 붙여넣고 계정에 slug(eidos, personal, client-acme)를 지정합니다.

4. Worker는 토큰을 Railway에 대해 검증하고 KV에 저장하며, Grok은 account_list를 통해 이를 확인합니다.

코드는 10분 후 만료되며, 일회용이고, 8회의 실패한 붙여넣기 후에는 소멸됩니다.

계정 토큰(railway.com/account/tokens), 워크스페이스 토큰, 프로젝트 토큰(프로젝트 → 설정 → 토큰)이 모두 허용됩니다. 종류가 기록되어 Grok이 범위를 알 수 있습니다.

여러 계정

각 페어링은 이름이 있는 슬롯입니다. Railway 도구는 선택적 account slug를 받습니다. 하나의 슬롯이 기본값입니다.

이는 CLI 모델(~/.railguey/accounts.json)과 일치합니다 — 이름 있는 계정, 하나의 기본 계정 — 홈 디렉터리 대신 Workers KV에 저장됩니다.

엔드포인트

• GET / — 상태 페이지

• GET /health — JSON 상태(비밀 정보 없음, 페어링된 계정 메타데이터 포함)

• GET /pair — 클레임 코드 입력

• GET|POST /pair/:code — Railway 토큰 붙여넣기

• POST /mcp — MCP Streamable HTTP(인증 필요)

비밀과 바인딩

• MCP_AUTH_TOKEN — Grok이 Authorization: Bearer …로 보내는 베어러 토큰

• KV ACCOUNTS (railguey-accounts) — 페어링된 Railway 토큰, 클레임 코드, 기본 slug

토큰을 커밋하지 마세요. wrangler.toml에는 KV 네임스페이스 id와 Cloudflare 계정 id만 있습니다.

Grok에서 연결

1. grok.com/connectors → 커넥터 추가 → 기타

2. 서버 URL: https://railguey.eidos-agi.workers.dev/mcp

3. 헤더: Authorization: Bearer <MCP_AUTH_TOKEN>

4. Grok에게 Railway 계정 페어링을 요청한 다음, 반환된 클레임 URL을 엽니다.

배포

main으로의 git push가 배포입니다. 이 저장소는 라이브 Worker에 영구적으로 연결되어 있습니다:

1. eidos-agi/railguey-mcp-cloudflare의 main으로 푸시합니다(특히 index.js).

2. Grok 자동화 railguey-git-deploy가 해당 푸시 시 실행되어 index.js를 Worker railguey에 업로드하고 KV와 MCP_AUTH_TOKEN을 유지합니다.

3. 푸시 이벤트가 누락된 경우 시간별 백업이 main을 재배포합니다.

GitHub에 Cloudflare API 토큰이 없습니다. Cloudflare GitHub App도 없습니다. MCP 동작을 변경하려면 index.js를 편집하고 푸시하면 됩니다.

loader.js는 Dynamic Worker Loader(엣지에서 git-pull)입니다. 라이브 상태가 아닙니다 — 이 Cloudflare 계정은 무료 Workers 요금제(API 10195)에 있습니다. wrangler.toml의 main은 index.js로 유지됩니다.

name = "railguey"는 변경하면 안 됩니다. Worker 이름을 바꾸면 라이브 호스트와 Grok의 커넥터 URL이 깨집니다.

라이선스

MIT