Подключи Chit Chats MCP к Gemini CLI

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

Chit Chats + Gemini

Доверьте ИИ отправки через Chit Chats: создание отправлений, сравнение тарифов доставки, печать этикеток, объединение посылок в партии для сдачи, отслеживание доставки и просмотр возвратов. Покупка доставки и возврат её стоимости остаются отключены, пока вы их не разрешите.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

CHIT_CHATS_ACCESS_TOKEN, CHIT_CHATS_CLIENT_ID

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

Настройка занимает около 2 минут. Нужен аккаунт Chit Chats: API access token из настроек и client ID из адреса вашей панели управления.

1. Войдите на chitchats.com и откройте Settings, Account (chitchats.com/settings/account). Создайте API access token и скопируйте его в CHIT_CHATS_ACCESS_TOKEN. Вставляйте только сам токен: он передаётся как есть в заголовке Authorization, без префикса Bearer.
2. Скопируйте ваш client ID в CHIT_CHATS_CLIENT_ID. Это число в адресе вашей панели Chit Chats, https://chitchats.com/clients/<client id>/..., например 999999.
3. Установите коннектор и проверьте подключение через chit_chats_list_shipments.

Cloud и self-hosting работают одинаково: в обоих случаях коннектор обращается к chitchats.com с вашим собственным токеном, больше ничего настраивать не нужно. Если удалить токен в Chit Chats, доступ сразу отзывается.

Пока вы не купите доставку, ничего не списывается: chit_chats_create_shipment с postage_type, равным unknown, создаёт отправление без оплаты доставки, а chit_chats_get_shipment затем показывает доступные тарифы с ценами. chit_chats_refresh_shipment обновляет устаревшие тарифы или меняет страховку, подпись и дату отправки. Создание отправлений, обновление тарифов и сборка партий ничего не стоят. Для адресов за пределами Канады и США нужны таможенные позиции (line items).

Покупка доставки идёт в фоне: после chit_chats_buy_postage у отправления сначала статус postage_requested; читайте его снова, пока он не станет ready или postage_purchase_failed. У готового отправления есть этикетка в виде ссылок PNG и ZPL (postage_label_png_url, postage_label_zpl_url): коннектор возвращает ссылки, а не файлы.

Партии для сдачи: партия (batch) объединяет посылки, которые вы сдаёте вместе, и имеет собственную этикетку. Создайте её через chit_chats_create_batch, добавьте отправления через chit_chats_add_shipments_to_batch (или уберите их через chit_chats_remove_shipments_from_batch) и распечатайте этикетку партии из chit_chats_get_batch.

Id, суммы и страницы: id отправления состоит из 10 букв и цифр (8ERNJ8SCQ9); id партии — число. Суммы — десятичные строки в валюте аккаунта, даты — в формате YYYY-MM-DD. Инструменты списков принимают limit (по умолчанию 100, не больше 1000) и page; страница короче limit — последняя.

Лимит запросов: Chit Chats допускает 2000 запросов за 5 минут на IP-адрес и аккаунт и сверх этого отвечает 429. Подождите столько секунд, сколько указано в заголовке Retry-After, и повторите.

Частые ошибки: 401 — Chit Chats отклонил access token: создайте новый в Settings, Account и вставьте его без слова Bearer. 403 — токен не относится к этому client ID: проверьте число в адресе вашей панели. 404 — клиента, отправления или партии с таким id нет: проверьте CHIT_CHATS_CLIENT_ID и берите id отправлений из chit_chats_list_shipments.

Только рабочий аккаунт: тестовая среда Chit Chats (staging.chitchats.com) требует отдельного аккаунта, и этот коннектор её не использует. Баланс аккаунта, счета и заказ забора посылок не входят в публичный API.

Что читает коннектор: отправления со статусом, адресом получателя, содержимым, объявленной ценностью, размерами и весом посылки, типом доставки, перевозчиком и его трек-кодом, датой отправки, списанными суммами, ссылками на этикетки, доступными тарифами с ценами и событиями отслеживания; количество отправлений и партий; партии со статусом и этикеткой для сдачи; возвраты, которые едут обратно к вам, со статусом и решением; а также публичное отслеживание любого недавнего отправления Chit Chats с ожидаемой датой доставки и каждым событием со временем и местом.

Отключено при установке: chit_chats_buy_postage, chit_chats_refund_shipment, chit_chats_delete_shipment и chit_chats_delete_batch. Покупка доставки списывает деньги с баланса вашего аккаунта Chit Chats; возврат аннулирует отправление, и отправить его больше нельзя; удаление безвозвратно убирает ожидающее отправление (ещё без оплаты доставки) или пустую партию. Включайте на странице коннектора только нужные; перед каждым изменением ИИ спрашивает ваше подтверждение, а перед каждой покупкой также подтверждает с вами отправление, тариф и цену. Создание и обновление отправлений, создание партий и перенос отправлений в них и из них включены: это ничего не стоит.

Шаг 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 теперь может вызывать инструменты Chit Chats.

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

Примеры запросов

• «Какие отправления ещё ждут без оплаты доставки, а какие готовы к сдаче?»
• «Создайте отправление для заказа 1042 по адресу ниже и сравните тарифы, прежде чем что-либо покупать.»
• «Соберите все готовые отправления в новую партию и дайте мне этикетку партии для печати.»
• «Где сейчас отправление 8ERNJ8SCQ9 и когда оно должно прийти?»
• «Покажите возвраты на удержании, для которых мне ещё нужно выбрать способ возврата.»

FAQ

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

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

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