Кратко
Дайте ИИ работать с Google Gemini через ваш собственный API-ключ: задавать вопросы моделям Gemini, анализировать изображения и PDF по ссылке, считать токены, создавать эмбеддинги, а также создавать и редактировать изображения с помощью Nano Banana, которые появляются прямо в чате.
Пошаговая настройка
Подключи Google Gemini API к Microsoft Copilot за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Google Gemini API в пошаговой настройке и добавь свой MCP URL в Microsoft Copilot. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для Google Gemini API
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Google Gemini API, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без
git clone, без локального сервера.
Gemini API + Microsoft Copilot
Дайте ИИ работать с Google Gemini через ваш собственный API-ключ: задавать вопросы моделям Gemini, анализировать изображения и PDF по ссылке, считать токены, создавать эмбеддинги, а также создавать и редактировать изображения с помощью Nano Banana, которые появляются прямо в чате.
Предварительные требования
Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:
GEMINI_API_KEY
Шаг 1 — Получите учётные данные
- Откройте Google AI Studio по адресу
https://aistudio.google.com/apikeyи войдите со своей учётной записью Google. - Нажмите Create API key, выберите или создайте проект Google Cloud и скопируйте ключ. Обычно он начинается с
AIza. - Вставьте его в
GEMINI_API_KEYи установите коннектор. Ключ отправляется только в Google. - Чтобы создавать изображения или получить более высокие лимиты, включите оплату для проекта ключа в AI Studio (Get API key, затем Set up billing). У моделей изображений нет бесплатного уровня.
- Запустите
gemini_list_models, чтобы увидеть, какие модели доступны вашему ключу. Это бесплатно.
Оплата: Gemini API работает с вашим собственным ключом. Каждый вызов, кроме списка моделей, Files API и подсчёта токенов, оплачивается проектом ключа или засчитывается в его бесплатный уровень. На бесплатном уровне текстовые модели и модели эмбеддингов бесплатны в пределах поминутных и суточных лимитов, а Google может использовать промпты с бесплатного уровня для улучшения своих продуктов. ИИ использует дешёвые и быстрые модели по умолчанию (gemini-3.1-flash-lite для текста, gemini-embedding-001 для эмбеддингов), пока вы не попросите более мощную, а gemini_count_tokens бесплатно оценивает длинный промпт до отправки.
Изображения платные: gemini_generate_image и gemini_edit_image создают или изменяют изображения с помощью Nano Banana и показывают их прямо в чате. Модель изображений по умолчанию стоит около 0,034 $ за изображение, самая мощная около 0,13 $, поэтому ИИ подтверждает у вас каждое изображение. Изображения больше 4 МБ не возвращаются: попросите меньший размер.
Файлы по ссылке: gemini_analyze_file_url отвечает на вопросы об изображении, PDF, текстовом или CSV-файле или коротком видео по публичной HTTPS-ссылке размером до 15 МБ. Gemini сам открывает ссылку, поэтому она должна работать без входа в систему. Инструменты Files API показывают и читают сохранённые файлы проекта, которые удаляются через 48 часов. gemini_delete_file при установке отключён.
Частые ошибки: 400 с недействительным ключом: ключ неверный или удалён, создайте новый в AI Studio. 403: ключ ограничен другими API (в Google Cloud console в разделе Credentials, API restrictions разрешите Generative Language API), API отключён в его проекте или ссылка на файл не публичная. 404: такого кода модели нет, проверьте через gemini_list_models. 429: достигнут лимит бесплатного или платного уровня либо модель изображений вызвана без включённой оплаты; подождите или включите оплату. Ошибка 400 о том, что бесплатный уровень недоступен, означает, что в вашем регионе он не предлагается: включите оплату. Запрос, заблокированный фильтрами безопасности Google, возвращается как ошибка и не повторяется.
Коннектор не загружает файлы, не передаёт аудио и видео в потоке (Live API), не создаёт речь и видео (Veo) и не работает с кэшированием контекста, пакетными заданиями, дообученными моделями и хранилищами для поиска по файлам.
Шаг 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 — Добавьте коннектор в Microsoft Copilot
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Microsoft Copilot использует MCP-серверы через агентов, созданных в Copilot Studio: ты добавляешь AnythingMCP в агента как инструмент, а затем публикуешь агента в Microsoft 365 Copilot и Teams. Copilot Studio подключается из облака Microsoft по Streamable HTTP, который AnythingMCP поддерживает.
- В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
- Укажи Server name (например,
AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер. - В аутентификации выбери API key, установи Type в Header, укажи имя заголовка
X-API-Keyи нажми Create. - В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
- Проверь в панели Test агента: попроси о том, для чего нужны инструменты
Gemini API. - Нажми Publish, затем Channels → Microsoft 365 and Microsoft Teams, оставь включённым Make agent available in Microsoft Copilot и нажми Add channel. See agent in Teams установит агента для тебя; в Microsoft 365 Copilot введи @ и выбери агента.
Хочешь, чтобы каждый входил под своей учётной записью? Вместо API-ключа выбери OAuth 2.0 → Dynamic discovery: каждый пользователь войдёт в AnythingMCP при первом вызове агентом.
Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Copilot Studio подключается из облака Microsoft, поэтому localhost не подойдёт.
Доступные инструменты
| Tool | What it does |
|---|---|
gemini_list_models | List the Gemini models this API key can use, with their input and output token limits, whether they think, and the methods they support… |
gemini_get_model | Read one Gemini model: display name, description, version, input and output token limits, default temperature, top-p and top-k, whether it… |
gemini_generate_text | Ask a Gemini model one question and get its text answer (generateContent) |
gemini_generate_content | Full generateContent call for conversations and mixed input. contents is the list of turns: [{"role": "user", "parts": [{"text": "..."}]}… |
gemini_analyze_file_url | Ask a Gemini model about a file on the web: an image, a PDF, a text or CSV file or a short video, given by its public HTTPS link (up to 15… |
gemini_count_tokens | Count how many input tokens a text is for a Gemini model, to estimate cost or check it fits the context window before a long call |
gemini_embed_text | Turn one text into an embedding vector (embedContent) for semantic search, clustering or similarity |
gemini_batch_embed_texts | Embed up to 20 texts in one call (batchEmbedContents); the vectors come back in the order given |
gemini_generate_image | Create a picture from a text description with a Gemini image model (Nano Banana) and return it as an image the user can see |
gemini_edit_image | Change an existing picture with a Gemini image model: describe the edit ("replace the sky with a sunset", "remove the person on the left"… |
gemini_list_files | List the files stored in the project's Gemini Files API (uploaded for prompts, or generated), newest first, with name, display name, MIME… |
gemini_get_file | Read one file of the Gemini Files API: display name, MIME type, size, state (PROCESSING, ACTIVE or FAILED), uri to use in… |
gemini_delete_file | Delete a file from the Gemini Files API before it expires |
Примеры запросов
- «Прочитайте PDF с прайс-листом поставщика по ссылке, которую я вставлю ниже, и перечислите все товары с ценами.»
- «Попросите Gemini переписать это описание товара для нашего интернет-магазина короче и дружелюбнее.»
- «Сколько токенов это коммерческое предложение для Gemini и сколько будет стоить его краткое изложение на модели по умолчанию?»
- «Создайте с помощью Nano Banana фото нашей синей керамической кружки на деревянном столе, но сначала назовите стоимость и дождитесь моего согласия.»
FAQ
Для какого Copilot это руководство? Для Microsoft 365 Copilot на работе — через агентов Copilot Studio. В приложении Microsoft Copilot для личных аккаунтов добавить свой MCP-сервер нельзя.
Что нужно? Рабочий аккаунт с доступом к Copilot Studio (лицензия или пробная версия), чтобы создать агента. Тем, кто будет пользоваться им в Microsoft 365 Copilot или Teams, нужен доступ к агенту: поделись им или попроси администратора опубликовать его для организации. Если в организации действуют политики данных для коннекторов Power Platform, они распространяются и на MCP-серверы.
Агент не вызывает инструменты. Проверь, что имя заголовка — ровно X-API-Key, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.
Следующие шаги
- Страница коннектора
- Подключить к Claude
- Подключить к ChatGPT
- Подключить к Cursor
- Подключить к Gemini
- Подключить к Meta Muse
Это руководство помогло?