Conectar Gitea MCP con Gemini CLI: issues y archivos

💡 ¿Sin instalar nada? Usa directamente cloud.anythingmcp.com. Inicia sesión, haz clic en Connectors → Gitea, pega tus credenciales, genera una clave de API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

Gitea + Gemini

Deja que tu IA lea tu Gitea: encuentra repositorios, clasifica issues y pull requests con sus comentarios, archivos, diffs y revisiones, consulta releases y organizaciones, y lee ramas, commits y archivos. gitea.com o tu propio servidor Gitea, con un token de acceso. Solo lectura.

Requisitos previos

Consulta las instrucciones de configuración completas incluidas en el conector (visibles en la tienda de la aplicación al seleccionar el conector). Las variables de entorno necesarias para este conector son:

GITEA_URL, GITEA_TOKEN

Paso 1 — Obtén las credenciales

La configuración lleva unos 2 minutos. Necesitas una cuenta en gitea.com o en tu propio servidor Gitea, y un token de acceso con permiso de lectura para Repository, Issue, Organization y User.

1. En Gitea, haz clic en tu avatar, después en Settings y luego en Applications. En Manage Access Tokens, escribe un nombre (por ejemplo "AnythingMCP") y establece Repository, Issue, Organization y User en Read (los scopes read:repository, read:issue, read:organization y read:user). En una versión de Gitea sin scopes de token, el token obtiene el acceso completo de su usuario.
2. Haz clic en Generate Token y copia el token de inmediato: Gitea lo muestra una sola vez. Pega únicamente el token en GITEA_TOKEN, sin la palabra token ni Bearer delante. El conector añade token por sí mismo.
3. Establece GITEA_URL con la dirección en la que abres Gitea, por ejemplo https://gitea.com o https://git.example.com, sin /api/v1 y sin barra final. Si Gitea se ejecuta bajo una subruta, mantenla (https://example.com/gitea).
4. Instala el conector y ejecuta gitea_get_current_user: muestra el usuario al que pertenece el token y confirma que la dirección y el token funcionan.

Solo lectura: las 30 herramientas solo leen. El conector no puede crear, modificar ni eliminar nada en Gitea, y la IA ve exactamente lo que puede ver el usuario del token.

Qué lee: repositorios (buscados en toda la instancia, o listados para tu usuario, una organización u otro usuario), issues con comentarios, etiquetas e hitos, pull requests con sus archivos modificados, diff, commits y revisiones, releases con notas y archivos adjuntos, organizaciones con miembros y equipos, ramas, commits, el árbol de archivos y el contenido de los archivos. gitea_search_issues encuentra issues y pull requests de todos los repositorios que te han sido asignados, que has creado tú o que esperan tu revisión.

Repositorios y números: cada repositorio recibe owner (un usuario u organización) y repo, las dos partes de https://host/owner/repo. Las issues y las pull requests comparten una misma secuencia de números por repositorio. Gitea trata también una pull request como una issue, de modo que gitea_get_issue y gitea_list_issue_comments funcionan también con el número de una pull request para obtener su título, etiquetas y conversación, mientras que gitea_get_pull_request, gitea_get_pull_request_files y gitea_get_pull_request_diff aportan la parte del código.

Tu propio servidor: un Gitea en un host interno (una IP privada o un nombre interno) necesita un AnythingMCP autoalojado en la misma red, con el nombre de host en SSRF_ALLOWED_HOSTS; de lo contrario, la protección de salida bloquea la llamada. Forgejo, y Codeberg que lo ejecuta, ofrecen las mismas rutas de la API v1, por lo que una dirección como https://codeberg.org también debería funcionar. El conector está escrito para la API de Gitea.

Límites: un servidor Gitea devuelve 30 elementos por página por defecto y como máximo 50 (su ajuste MAX_RESPONSE_ITEMS), así que la IA pide la página siguiente en lugar de un límite mayor. Los diffs de pull requests y los contenidos de archivos de más de 200 KB se recortan: abre el html_url de la pull request para ver el resto.

Errores comunes: 401 significa que el token es incorrecto, ha caducado o se ha eliminado, o que GITEA_URL apunta a otro servidor. 403 significa que el token carece de un scope que necesita la llamada (Gitea lo indica en el mensaje), por ejemplo read:issue para issues o read:organization para organizaciones. 404 significa que el repositorio, la issue o el archivo no existe o que el usuario no puede verlo: Gitea responde 404 para los recursos privados que oculta. 422 indica un campo ausente o no válido.

El conector no crea ni edita issues, comentarios, pull requests, releases, ramas ni archivos, no fusiona ni aprueba, y no cubre ejecuciones y flujos de trabajo de Actions, paquetes, wikis, notificaciones, webhooks, claves de despliegue ni administración.

Paso 2 — Instala el adaptador

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

Paso 3 — Añade el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

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

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Gitea.

Herramientas disponibles

Preguntas frecuentes

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Próximos pasos

• Página del conector
• Conectar con Claude
• Conectar con ChatGPT