Gitea MCP mit Cursor verbinden

💡 Keine Installation? Nutze direkt cloud.anythingmcp.com. Melde dich an, klicke auf Connectors → Gitea, füge deine Zugangsdaten ein, erstelle einen MCP-API-Key — fertig. Kein Docker, kein git clone, kein lokaler Server.

Gitea + Cursor

Lass deine KI dein Gitea lesen: Repositories finden, Issues und Pull Requests samt Kommentaren, Dateien, Diffs und Reviews sichten, Releases und Organisationen prüfen sowie Branches, Commits und Dateien lesen. gitea.com oder dein eigener Gitea-Server, mit einem Access Token. Nur lesend.

Voraussetzungen

Die vollständige Einrichtungsanleitung ist direkt im Connector enthalten (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:

GITEA_URL, GITEA_TOKEN

Schritt 1 — Zugangsdaten besorgen

Die Einrichtung dauert etwa 2 Minuten. Du brauchst ein Konto auf gitea.com oder auf deinem eigenen Gitea-Server und einen Access Token mit Leseberechtigung für Repository, Issue, Organization und User.

1. Klicke in Gitea auf deinen Avatar, dann auf Settings und danach auf Applications. Gib unter Manage Access Tokens einen Namen ein (zum Beispiel „AnythingMCP“) und setze Repository, Issue, Organization und User auf Read (die Scopes read:repository, read:issue, read:organization und read:user). Bei einer Gitea-Version ohne Token-Scopes erhält der Token den vollen Zugriff seines Benutzers.
2. Klicke auf Generate Token und kopiere den Token sofort: Gitea zeigt ihn nur einmal an. Füge nur den Token in GITEA_TOKEN ein, ohne das Wort token oder Bearer davor. Der Connector ergänzt token selbst.
3. Setze GITEA_URL auf die Adresse, unter der du Gitea öffnest, zum Beispiel https://gitea.com oder https://git.example.com, ohne /api/v1 und ohne abschließenden Schrägstrich. Wenn Gitea unter einem Unterpfad läuft, behalte ihn bei (https://example.com/gitea).
4. Installiere den Connector und führe gitea_get_current_user aus: Das Tool zeigt den Benutzer, zu dem der Token gehört, und bestätigt, dass Adresse und Token funktionieren.

Nur lesend: Alle 30 Tools lesen ausschließlich. Der Connector kann in Gitea nichts erstellen, ändern oder löschen, und die KI sieht genau das, was der Benutzer des Tokens sehen kann.

Was gelesen wird: Repositories (über die gesamte Instanz durchsucht oder aufgelistet für deinen Benutzer, eine Organisation oder einen anderen Benutzer), Issues mit Kommentaren, Labels und Meilensteinen, Pull Requests mit ihren geänderten Dateien, Diff, Commits und Reviews, Releases mit Notizen und angehängten Dateien, Organisationen mit Mitgliedern und Teams, Branches, Commits, der Dateibaum und Dateiinhalte. gitea_search_issues findet Issues und Pull Requests über alle Repositories hinweg, die dir zugewiesen sind, von dir erstellt wurden oder auf dein Review warten.

Repositories und Nummern: Jedes Repository erwartet owner (ein Benutzer oder eine Organisation) und repo, die beiden Teile von https://host/owner/repo. Issues und Pull Requests teilen sich pro Repository eine Nummernfolge. Gitea behandelt einen Pull Request auch als Issue, daher funktionieren gitea_get_issue und gitea_list_issue_comments auch mit der Nummer eines Pull Requests für Titel, Labels und Unterhaltung, während gitea_get_pull_request, gitea_get_pull_request_files und gitea_get_pull_request_diff die Code-Seite liefern.

Dein eigener Server: Ein Gitea auf einem internen Host (eine private IP oder ein interner Name) erfordert ein self-hosted AnythingMCP im selben Netzwerk, wobei der Hostname in SSRF_ALLOWED_HOSTS stehen muss, sonst blockiert der Outbound-Schutz den Aufruf. Forgejo und Codeberg, das darauf läuft, bieten dieselben API-v1-Routen, daher sollte auch eine Adresse wie https://codeberg.org funktionieren. Der Connector ist gegen die Gitea-API geschrieben.

Limits: Ein Gitea-Server liefert standardmäßig 30 Einträge pro Seite und höchstens 50 (seine Einstellung MAX_RESPONSE_ITEMS), daher fragt die KI nach der nächsten Seite, statt ein größeres Limit zu verwenden. Pull-Request-Diffs und Dateiinhalte über 200 KB werden abgeschnitten: Öffne die html_url des Pull Requests für den Rest.

Häufige Fehler: 401 bedeutet, dass der Token falsch, abgelaufen oder gelöscht ist oder dass GITEA_URL auf einen anderen Server zeigt. 403 bedeutet, dass dem Token ein Scope fehlt, den der Aufruf braucht (Gitea nennt ihn in der Meldung), zum Beispiel read:issue für Issues oder read:organization für Organisationen. 404 bedeutet, dass das Repository, das Issue oder die Datei nicht existiert oder der Benutzer sie nicht sehen kann: Gitea antwortet mit 404 auf private Ressourcen, die es verbirgt. 422 nennt ein fehlendes oder ungültiges Feld.

Der Connector erstellt oder bearbeitet keine Issues, Kommentare, Pull Requests, Releases, Branches oder Dateien, führt keine Merges durch und genehmigt nichts, und deckt keine Actions-Runs und Workflows, Pakete, Wikis, Benachrichtigungen, Webhooks, Deploy Keys oder Administration ab.

Schritt 2 — Den Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Den Connector in Cursor hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent kann jetzt die Gitea-Tools aufrufen.

Verfügbare Tools

FAQ

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja — MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

• Connector-Landingpage
• Mit Claude verbinden
• Mit ChatGPT verbinden