railguey-mcp-cloudflare

Railguey in der Cloud. Ein Cloudflare-Worker-MCP-Server, der Grok mit Railwary GraphQL verbindet.

Die CLI befindet sich in eidos-agi/railguey. Dieses Repositorium ist der gehostete Streamable-HTTP-MCP, den Grok tatsächlich als Connector hinzufügen kann — Railwarys eigener MCP (mcp.railwary.com) ist auf OAuth/CLI ausgelegt und kann nicht direkt zu Grok hinzugefügt werden.

Live-Worker: railguey.eidos-agi.workers.dev

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

Produktseite: eidosagi.com/tools/railguey

Warum ein separates Repositorium

Das Worker-Skript heißt auf Cloudflare weiterhin railguey. Dieser Name ist der workers.dev-Host und muss mit wrangler.toml name übereinstimmen. Das GitHub-Repository ist nach dem benannt, was es ist.

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

Pairing (Claim-Codes)

Railway-Tokens gehen nie durch den Grok-Chat. Pairing ist ein Device-Code-Flow:

1. Grok ruft account_pair_begin auf (oder hier wird ein Code erzeugt).

2. Du öffnest /pair/<CODE> auf diesem Worker.

3. Füge ein Railway-Token ein und gib dem Konto einen Slug (eidos, personal, client-acme).

4. Der Worker validiert das Token gegenüber Railway, speichert es in KV, und Grok sieht es über account_list.

Codes verfallen nach 10 Minuten, sind nur einmal verwendbar und sind nach 8 fehlgeschlagenen Einfügeversuchen verbraucht.

Kontotokens (railway.com/account/tokens), Workspace-Tokens und Projekttokens (Projekt → Einstellungen → Tokens) werden alle akzeptiert. Die Art wird aufgezeichnet, damit Grok den Umfang kennt.

Mehrere Konten

Jedes Pairing ist ein benannter Slott. Railwary-Tools akzeptieren einen optinalen account- Slug. Ein Slott ist der Standard.

Dies entspricht dem CLI-Modell (~/.railguey/accounts.json) — benannte Konten, ein Standard —, das in Workers KV statt in einem Home-Verzeichnis gespeichert wird.

Endpunkte

• GET / — Statusseite

• GET /health — JSON-Health (keine Geheimnisse; enthält Metadaten der gepaarten Konten)

• GET /pair — einen Claim-Code eingeben

• GET|POST /pair/:code — ein Railway-Token einfügen

• POST /mcp — MCP Streamable HTTP (Authentifizierung erforderlich)

Geheimnisse und Bindungen

• MCP_AUTH_TOKEN — Bearer-Token, das Grok als Authorization: Bearer … sendet

• KV ACCOUNTS (railguey-accounts) — gepaarte Railwary-Tokens, Claim-Codes, Standard-Slug

Tokens niemals committen. wrangler.toml enthält nur die KV-Namespace-ID und die Cloudflare-Konto-ID.

In Grok verbinden

1. grok.com/connectors → Connector hinzufügen → Andere

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

3. Header: Authorization: Bearer <MCP_AUTH_TOKEN>

4. Bitte Grok, ein Railway-Konto zu pairen, und öffne dann die Claim-URL, die es zurückgibt.

Deployment

git push auf main ist das Deployment. Dieses Repository ist dauerhaft an den Live-Worker gekoppelt:

1. Pushe auf eidos-agi/railguey-mcp-cloudflare main (insbesondere index.js).

2. Die Grok-Automatisierung railguey-git-deploy wird bei diesem Push ausgelöst, lädt index.js in den Worker railguey hoch und behält KV + MCP_AUTH_TOKEN bei.

3. Ein stündliches Backup stellt main erneut bereit, falls ein Push-Ereignis verpasst wird.

Kein Cloudflare-API-Token in GitHub. Keine Cloudflare-GitHub-App. Das Ändern des MCP-Verhaltens bedeutet, index.js zu bearbeiten und zu pushen.

loader.js ist ein Dynamic Worker Loader (Git-Pull am Edge). Er ist nicht live – dieses Cloudflare-Konto befindet sich im kostenlosen Workers-Plan (API 10195). wrangler.toml main bleibt index.js.

name = "railguey" darf sich nicht ändern. Eine Umbenennung des Workers würde den Live-Host und Groks Connector-URL brechen.

Lizenz

MIT