AGS Extend SDK MCP Server

AGS Extend SDK MCP Server

Ein Model Context Protocol (MCP)-Server, der KI-Assistenten (VS Code Copilot, Cursor, Claude, Gemini, Antigravity) das AccelByte Extend SDK als zusätzlichen Kontext bereitstellt – damit sie Fragen zum SDK beantworten und korrekten Extend SDK-Code generieren können.

Was er macht

• Durchsuchen von Extend SDK-Symbolen (Funktionen und Modelle) nach Name, Tags oder Beschreibung (unscharfe Suche)
• Beschreiben bestimmter Symbole – Parameter, Felder, Importe, Beispiele, Rückgabetypen, erforderliche Berechtigungen
• Gerüstbau einer neuen Extend-App aus einem Vorlagen-Repository über den create-extend-app-Prompt

Er dient als SDK-Referenz für vier Sprachen – C#, Go, Java und Python. Sie wählen die Sprache pro Verbindung über den URL-Pfad (siehe Sprache wählen).

AccelByte hostet den Extend SDK MCP Server für Sie – Sie müssen nichts lokal installieren oder ausführen. Verweisen Sie einfach Ihren KI-Assistenten auf die gehostete MCP-URL für Ihre Sprache. Es gibt keine Anmeldung: Der Server stellt nur lesbare SDK-Referenzdaten bereit. Möchten Sie ihn lieber selbst betreiben? Siehe Lokal ausführen & Self-Hosting.

---

Schnellinstallation

Fügen Sie dies in Ihren KI-Coding-Assistenten ein – er ruft die Installationsanleitung ab, stellt Ihnen ein paar Fragen und konfiguriert alles für Sie:

Install the AGS Extend SDK MCP server for me. Fetch and follow the instructions at
https://raw.githubusercontent.com/AccelByte/ags-extend-sdk-mcp-server/refs/heads/master/INSTALL.md

Funktioniert in VS Code Copilot, Cursor, Claude Code, Antigravity und Gemini CLI.

Claude Desktop-Benutzer: Der einfachste Weg ist Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen (Name: extend-sdk, URL: Ihre MCP-URL) – kein KI-Installer nötig. Siehe Claude Desktop unten.

Wenn Sie den obigen Schnellinstallations-Prompt verwenden möchten, wechseln Sie zuerst zum Tab Code (Chat und Cowork können Ihre Konfigurationsdatei nicht bearbeiten).

Möchten Sie es lieber selbst machen? Siehe Manuelle Installation unten.

---

Manuelle Installation

Schritt 1: Sprache wählen und URL erhalten

Die MCP-URL ist die Basis-URL des gehosteten Servers, gefolgt von /extend-mcp/{language}:

https://<mcp-server-host>/extend-mcp/{language}

Sprache	URL-Pfad
C#	/extend-mcp/csharp
Go	/extend-mcp/go
Java	/extend-mcp/java
Python	/extend-mcp/python

• <mcp-server-host> ist der Host der Bereitstellung Ihrer Organisation – fragen Sie Ihren AccelByte-Administrator, wenn Sie unsicher sind.
• Eine gehostete Instanz bedient alle Sprachen. Um später die Sprache zu wechseln, ändern Sie einfach das abschließende Pfadsegment (z. B. /extend-mcp/python → /extend-mcp/go). Die Anfrage einer unbekannten Sprache gibt HTTP 400 zurück.
• Der Basispfad (/extend-mcp) ohne Sprache bedient die konfigurierte Standardsprache des Servers.

Keine gehostete Instanz? Sie können den Server selbst mit Docker betreiben – siehe Lokal ausführen & Self-Hosting.

Schritt 2: Client konfigurieren

Der Server verwendet Streamable HTTP-Transport. Clients, die HTTP-Transport unterstützen, verbinden sich direkt mit der URL. Clients, die nur stdio-Transport unterstützen, verwenden mcp-remote als Brücke.

Brauchen Sie mcp-remote? Es läuft über npx, daher benötigen Sie Node.js 18+ mit verfügbarem npx – überprüfen mit npx --version. Keine globale Installation erforderlich.

Ersetzen Sie Ihre URL aus Schritt 1 überall dort, wo Sie <URL> unten sehen.

Visual Studio Code (Copilot)

.vscode/mcp.json in Ihrem Workspace (oder Benutzer-settings.json):

{
  "servers": {
    "extend-sdk": {
      "type": "http",
      "url": "<URL>"
    }
  }
}

Wenn Ihr Client keinen HTTP-Server erreichen kann, wechseln Sie zu: { "command": "npx", "args": ["-y", "mcp-remote", "<URL>"] }.

Siehe die VS Code MCP-Dokumentation.

Cursor

.cursor/mcp.json in Ihrem Workspace (oder Benutzereinstellungen):

{
  "mcpServers": {
    "extend-sdk": {
      "type": "http",
      "url": "<URL>"
    }
  }
}

Wenn Ihr Client keinen HTTP-Server erreichen kann, wechseln Sie zu: { "command": "npx", "args": ["-y", "mcp-remote", "<URL>"] }.

Siehe die Cursor MCP-Dokumentation.

Claude Code

claude mcp add --transport http extend-sdk <URL>

Fallback (Nur-stdio-Umgebungen): claude mcp add extend-sdk -- npx -y mcp-remote <URL>.

Siehe die Claude Code MCP-Dokumentation.

Antigravity

mcp_config.json in Ihrem Projektstamm:

{
  "mcpServers": {
    "extend-sdk": {
      "type": "http",
      "url": "<URL>"
    }
  }
}

Wenn Ihr Client keinen HTTP-Server erreichen kann, wechseln Sie zu: { "command": "npx", "args": ["-y", "mcp-remote", "<URL>"] }.

Siehe die Antigravity MCP-Dokumentation.

Gemini CLI

gemini mcp add --transport http extend-sdk <URL>

Fallback (Nur-stdio-Umgebungen): gemini mcp add extend-sdk -- npx -y mcp-remote <URL>.

Siehe die Gemini CLI MCP-Dokumentation.

Claude Desktop

Option A – Benutzerdefinierter Connector (empfohlen)

1. Öffnen Sie Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen (im Bereich „Anpassen“).
2. Füllen Sie Name: extend-sdk und Remote-MCP-Server-URL: Ihre <URL> aus Schritt 1 aus.
3. Speichern.

Sehen Sie „Benutzerdefinierten Connector hinzufügen“ nicht? Einige Team- und Enterprise-Pläne deaktivieren benutzerdefinierte Connectors per Workspace-Richtlinie. Wenn die Option fehlt oder ausgegraut ist, verwenden Sie Option B.

Option B – mcp-remote-Konfigurationsdatei (Fallback)

Bearbeiten Sie claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "extend-sdk": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "<URL>"]
    }
  }
}

Starten Sie Claude Desktop nach dem Speichern neu.

---

Verwendung der Werkzeuge

Sobald die Verbindung hergestellt ist, hat Ihr Assistent Zugriff auf diese Werkzeuge. Probieren Sie im Chat Ihres Assistenten die folgenden Beispiel-Prompts aus – erteilen Sie die Berechtigung zur Ausführung der Werkzeuge, wenn Sie dazu aufgefordert werden.

search-symbols

Durchsucht Extend SDK-Symbole nach Name, Tags oder Beschreibung mit unscharfer Suche. Gibt eine paginierte Liste von Zusammenfassungen zurück.

"Suche nach Symbolen, die mit Benutzer zu tun haben" · "Finde Symbole für Inventar"

describe-symbols

Ruft vollständige Details zu bestimmten Symbolen anhand der ID ab – Felder, Parameter, Importe, Beispielverwendung, Rückgabetyp und erforderliche Berechtigungen.

"Beschreibe die Symbole AdminCreateUser@iam und User@iam"

create-extend-app

Eine Prompt-Vorlage, die ein Extend-App-Vorlagen-Repository klont und öffnet (in einem Dev-Container, falls verfügbar), sodass Sie mit einem funktionierenden Beispiel beginnen können.

Rufen Sie den create-extend-app-Prompt auf und folgen Sie den Vervollständigungen für Szenario / Vorlage / Sprache.

[!TIP] Wenn Sie mit diesem MCP-Server programmieren, beginnen Sie mit einem Extend SDK-Einstiegsbeispiel oder einer Extend-App-Vorlage anstelle eines leeren Projekts und fügen Sie relevante Quelldateien als Kontext hinzu, um bessere Ergebnisse zu erzielen.

---

Selbst ausführen

Möchten Sie den Server lieber lokal (stdio) ausführen oder den HTTP-Server selbst hosten? Siehe Lokal ausführen & Self-Hosting für Docker-Nutzung, Umgebungsvariablen, HTTP-Endpunkte, Entwicklung aus dem Quellcode und Veröffentlichung des Images.

---

Fehlerbehebung

Werkzeugaufrufe schlagen fehl / der Server gibt 400 zurück

Überprüfen Sie die Sprache in Ihrem URL-Pfad. Sie muss eine der folgenden sein: csharp, go, java oder python (z. B. /extend-mcp/go). Eine unbekannte Sprache gibt HTTP 400 zurück.

Client kann keine Verbindung zur HTTP-URL herstellen

Einige Clients unterstützen nur stdio-Transport. Wechseln Sie bei diesem Client zur mcp-remote-Brückenkonfiguration, die in Schritt 2 gezeigt wird. Dafür wird Node.js 18+ mit verfügbarem npx benötigt (npx --version).

„Verbindung abgelehnt“ oder der Host ist nicht erreichbar

Stellen Sie sicher, dass der <mcp-server-host> und die vollständige URL korrekt sind (fragen Sie Ihren AccelByte-Administrator) und dass Ihr Netzwerk sie erreichen kann.

---

Dokumentation

• Installationsanleitung – wird vom Schnellinstallations-Prompt befolgt; auch eigenständig lesbar
• Lokal ausführen & Self-Hosting – Docker, Umgebungsvariablen, HTTP-Endpunkte, Entwicklung und Veröffentlichung des Images

Beiträge

Dieses Repository wird unverändert veröffentlicht. Für Fehlerberichte und Fragen öffnen Sie bitte ein Issue.