Collegare Gitea MCP a Cursor: file e commit

💡 Non vuoi installare nulla? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connectors → Gitea, incolla le tue credenziali, genera una chiave API MCP — fatto. Niente Docker, niente git clone, nessun server locale.

Gitea + Cursor

Lascia che la tua AI legga il tuo Gitea: trova repository, smista issue e pull request con commenti, file, diff e revisioni, controlla release e organizzazioni, e leggi branch, commit e file. gitea.com o il tuo server Gitea, con un token di accesso. Sola lettura.

Prerequisiti

Consulta le istruzioni complete di configurazione incluse nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili d'ambiente richieste da questo connettore sono:

GITEA_URL, GITEA_TOKEN

Passo 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti serve un account su gitea.com o sul tuo server Gitea, e un token di accesso con permesso di lettura per Repository, Issue, Organization e User.

1. In Gitea, clicca sul tuo avatar, poi su Settings, poi su Applications. In Manage Access Tokens, digita un nome (per esempio "AnythingMCP") e imposta Repository, Issue, Organization e User su Read (gli scope read:repository, read:issue, read:organization e read:user). Su una versione di Gitea senza scope per i token, il token ottiene l'accesso completo del suo utente.
2. Clicca su Generate Token e copia subito il token: Gitea lo mostra una sola volta. Incolla solo il token in GITEA_TOKEN, senza la parola token o Bearer davanti. Il connettore aggiunge token da solo.
3. Imposta GITEA_URL sull'indirizzo con cui apri Gitea, per esempio https://gitea.com o https://git.example.com, senza /api/v1 e senza barra finale. Se Gitea gira in un sottopercorso, mantienilo (https://example.com/gitea).
4. Installa il connettore ed esegui gitea_get_current_user: mostra l'utente a cui appartiene il token e conferma che indirizzo e token funzionano.

Sola lettura: tutti i 30 strumenti si limitano a leggere. Il connettore non può creare, modificare o eliminare nulla in Gitea, e l'AI vede esattamente ciò che può vedere l'utente del token.

Cosa legge: repository (cercati in tutta l'istanza, oppure elencati per il tuo utente, per un'organizzazione o per un altro utente), issue con commenti, etichette e milestone, pull request con i file modificati, diff, commit e revisioni, release con note e file allegati, organizzazioni con membri e team, branch, commit, l'albero dei file e il contenuto dei file. gitea_search_issues trova issue e pull request in tutti i repository che sono assegnate a te, create da te o in attesa della tua revisione.

Repository e numeri: ogni repository richiede owner (un utente o un'organizzazione) e repo, le due parti di https://host/owner/repo. Issue e pull request condividono un'unica sequenza di numeri per repository. Gitea tratta una pull request anche come un'issue, quindi gitea_get_issue e gitea_list_issue_comments funzionano anche con il numero di una pull request per titolo, etichette e conversazione, mentre gitea_get_pull_request, gitea_get_pull_request_files e gitea_get_pull_request_diff forniscono il lato del codice.

Il tuo server: un Gitea su un host interno (un IP privato o un nome interno) richiede un AnythingMCP self-hosted sulla stessa rete, con l'hostname in SSRF_ALLOWED_HOSTS, altrimenti la protezione in uscita blocca la chiamata. Forgejo, e Codeberg che lo usa, offrono le stesse route API v1, quindi anche un indirizzo come https://codeberg.org dovrebbe funzionare. Il connettore è scritto per l'API di Gitea.

Limiti: un server Gitea restituisce 30 elementi per pagina per impostazione predefinita e al massimo 50 (la sua impostazione MAX_RESPONSE_ITEMS), quindi l'AI chiede la pagina successiva invece di un limite più grande. I diff delle pull request e i contenuti dei file oltre i 200 KB vengono troncati: apri l'html_url della pull request per il resto.

Errori comuni: 401 significa che il token è errato, scaduto o eliminato, oppure che GITEA_URL punta a un altro server. 403 significa che al token manca uno scope necessario alla chiamata (Gitea lo indica nel messaggio), per esempio read:issue per le issue o read:organization per le organizzazioni. 404 significa che il repository, l'issue o il file non esiste oppure che l'utente non può vederlo: Gitea risponde 404 per le risorse private che nasconde. 422 indica un campo mancante o non valido.

Il connettore non crea né modifica issue, commenti, pull request, release, branch o file, non esegue merge né approvazioni, e non copre esecuzioni e workflow di Actions, pacchetti, wiki, notifiche, webhook, deploy key o amministrazione.

Passo 2 — Installa l'adapter

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

Passo 3 — Aggiungi il connettore in Cursor

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

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

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di Gitea.

Strumenti disponibili

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì — MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Pagina del connettore
• Collega a Claude
• Collega a ChatGPT