Подключить Gitea MCP к Gemini CLI: задачи и файлы

💡 Не хочешь ничего устанавливать? Используй cloud.anythingmcp.com напрямую. Войди, нажми Connectors → Gitea, вставь свои учётные данные, создай API-ключ MCP — и всё готово. Без Docker, без git clone, без локального сервера.

Gitea + Gemini

Позволь своему ИИ читать твой Gitea: искать репозитории, разбирать задачи и пулл-реквесты вместе с комментариями, файлами, диффами и ревью, проверять релизы и организации, читать ветки, коммиты и файлы. gitea.com или твой собственный сервер Gitea, с токеном доступа. Только чтение.

Требования

Полную инструкцию по настройке смотри в самом коннекторе (она видна в магазине внутри приложения, когда ты выбираешь коннектор). Для этого коннектора нужны следующие переменные окружения:

GITEA_URL, GITEA_TOKEN

Шаг 1 — Получи учётные данные

Настройка занимает около 2 минут. Тебе нужна учётная запись на gitea.com или на твоём собственном сервере Gitea и токен доступа с правом чтения (Read) для Repository, Issue, Organization и User.

1. В Gitea нажми на свой аватар, затем Settings, затем Applications. В разделе Manage Access Tokens введи имя (например, «AnythingMCP») и установи для Repository, Issue, Organization и User значение Read (скоупы read:repository, read:issue, read:organization и read:user). В версии Gitea без скоупов токена токен получает полный доступ своего пользователя.
2. Нажми Generate Token и сразу скопируй токен: Gitea показывает его только один раз. Вставь в GITEA_TOKEN только сам токен, без слова token или Bearer перед ним. Коннектор добавляет token сам.
3. Укажи в GITEA_URL адрес, по которому ты открываешь Gitea, например https://gitea.com или https://git.example.com, без /api/v1 и без завершающего слеша. Если Gitea работает в подпути, сохрани его (https://example.com/gitea).
4. Установи коннектор и запусти gitea_get_current_user: он покажет пользователя, которому принадлежит токен, и подтвердит, что адрес и токен работают.

Только чтение: все 30 инструментов только читают. Коннектор не может ничего создавать, изменять или удалять в Gitea, а ИИ видит ровно то, что видит пользователь токена.

Что он читает: репозитории (поиск по всему инстансу или список для твоего пользователя, организации или другого пользователя), задачи с комментариями, метками и вехами, пулл-реквесты с изменёнными файлами, диффом, коммитами и ревью, релизы с описанием и прикреплёнными файлами, организации с участниками и командами, ветки, коммиты, дерево файлов и содержимое файлов. gitea_search_issues находит задачи и пулл-реквесты во всех репозиториях, которые назначены тебе, созданы тобой или ждут твоего ревью.

Репозитории и номера: каждый репозиторий принимает owner (пользователь или организация) и repo — две части адреса https://host/owner/repo. Задачи и пулл-реквесты используют одну последовательность номеров на репозиторий. Gitea считает пулл-реквест тоже задачей, поэтому gitea_get_issue и gitea_list_issue_comments работают и с номером пулл-реквеста, возвращая его заголовок, метки и обсуждение, а gitea_get_pull_request, gitea_get_pull_request_files и gitea_get_pull_request_diff показывают сторону кода.

Твой собственный сервер: Gitea на внутреннем хосте (приватный IP или внутреннее имя) требует self-hosted AnythingMCP в той же сети, с именем хоста в SSRF_ALLOWED_HOSTS, иначе исходящая защита заблокирует вызов. Forgejo и Codeberg, который на нём работает, предлагают те же маршруты API v1, поэтому адрес вроде https://codeberg.org тоже должен работать. Коннектор написан под API Gitea.

Ограничения: сервер Gitea по умолчанию возвращает 30 элементов на страницу и не более 50 (настройка MAX_RESPONSE_ITEMS), поэтому ИИ запрашивает следующую страницу, а не больший лимит. Диффы пулл-реквестов и содержимое файлов размером более 200 КБ обрезаются: остальное открой по html_url пулл-реквеста.

Частые ошибки: 401 означает, что токен неверен, просрочен или удалён либо GITEA_URL указывает на другой сервер. 403 означает, что у токена нет скоупа, нужного для вызова (Gitea называет его в сообщении), например read:issue для задач или read:organization для организаций. 404 означает, что репозиторий, задача или файл не существует либо пользователь не может его видеть: Gitea отвечает 404 для приватных ресурсов, которые скрывает. 422 указывает на отсутствующее или недопустимое поле.

Коннектор не создаёт и не редактирует задачи, комментарии, пулл-реквесты, релизы, ветки или файлы, не выполняет слияние и не одобряет, а также не охватывает запуски и воркфлоу Actions, пакеты, вики, уведомления, вебхуки, deploy-ключи и администрирование.

Шаг 2 — Установи адаптер

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

Шаг 3 — Добавь коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows — %USERPROFILE%\.gemini\settings.json). Добавь:

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

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале) — anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Gitea.

Доступные инструменты

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Дальнейшие шаги

• Страница коннектора
• Подключение к ChatGPT

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT