Как подключить Klardaten (DATEV) к Gemini — через MCP

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

Klardaten (DATEV) + Gemini

API Klardaten для системы DATEV налоговой консультационной фирмы: основные данные клиентов, декларации по подоходному, корпоративному и промысловому налогу, бухгалтерия (проводки, оборотно-сальдовая ведомость SuSa, банковские операции), расчёт зарплаты LODAS, аналитика фирмы и сквозной доступ к DATEVconnect только для чтения.

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

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

KLARDATEN_API_KEY, KLARDATEN_INSTANCE_ID

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

Конфиденциальные данные: прочтите сначала. Этот коннектор через Klardaten читает данные DATEV налоговой консультационной фирмы: основные данные, налоговые декларации, бухгалтерию и зарплату клиентов фирмы, включая оклады, налоговые номера, даты рождения и банковские операции частных лиц и компаний. Эти данные защищены профессиональной тайной (§ 203 StGB, § 57 StBerG) и GDPR. Добавляйте коннектор только на серверы, пользователи которых вправе видеть всё это, например партнёры или сотрудники, у которых уже есть такой доступ в DATEV, и никогда на общий или общекорпоративный сервер. API-ключ действует с правами стоящего за ним профиля DATEV, поэтому модель видит всё, что может читать этот профиль.

1. На сервере DATEV фирмы должен быть установлен и запущен коннектор Klardaten, а в панели Klardaten должна быть создана инстанция DATEV.
2. Войдите на https://dashboard.klardaten.com и создайте API-ключ для своего пользователя. Он начинается с uk-; укажите его в KLARDATEN_API_KEY (передаётся как Authorization: Bearer).
3. Скопируйте id инстанции DATEV (UUID) в KLARDATEN_INSTANCE_ID. Каждый запрос к DATEV передаёт его в заголовке x-client-instance-id; klardaten_list_instances показывает инстанции, доступные ключу.
4. Сначала вызовите klardaten_get_me, чтобы проверить доступ, затем klardaten_list_clients (основные данные), klardaten_list_accounting_clients (бухгалтерия), klardaten_list_payroll_clients (зарплата LODAS) или klardaten_list_firm_clients (аналитика фирмы).

Идентификаторы зависят от области: основные данные используют UUID, бухгалтерия числовой client_id и финансовые годы в формате YYYYMMDD, зарплата и аналитика фирмы client_number. Всегда фильтруйте klardaten_list_postings по client_id и fiscal_year: по всем клиентам фирмы запрос может завершиться по таймауту. Эндпоинты бухгалтерии, зарплаты, налогов и аналитики зависят от тарифа Klardaten и вне его отвечают 403. klardaten_search_documents требует дополнения Klardaten для поиска документов и устанавливается выключенным. Если вызовы DATEV падают, а klardaten_get_me работает, проверьте klardaten_get_datevconnect_health.

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

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

(showing 30 of 49 tools — install the connector to see them all)

FAQ

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

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

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