DATEV Sandbox MCPでGemini CLIと接続

💡 インストールは不要ですか?cloud.anythingmcp.com をそのままご利用ください。 サインインして Connectors → DATEV Online APIs (Sandbox) をクリックし、認証情報を貼り付けて MCP API キーを発行するだけです。Docker も git clone もローカルサーバーも不要です。

DATEV Online APIs (Sandbox) + Gemini

DATEV Online APIs のサンドボックス環境です。DATEV のテストデータを使って、会計の Mandanten(クライアント)、書類タイプ、DUO のバージョンメタデータを読み取れます。開発とテストの間はこちらを使用してください。DATEV が本番利用を承認するまで、すべての DATEV アプリはサンドボックスで動作させる必要があります。本番環境と同じ OAuth2 Authorization Code + PKCE フローで、接続先が DATEV のサンドボックスエンドポイントになります。

前提条件

コネクターに組み込まれているセットアップ手順の全文を参照してください(アプリ内ストアでコネクターを選択すると表示されます)。このコネクターに必要な環境変数は次のとおりです。

DATEV_CLIENT_ID, DATEV_CLIENT_SECRET

ステップ 1 — 認証情報を取得する

セットアップには約 10 分かかります。DATEV-Entwicklerportal 上のアプリと、サインインに使う DATEV-Konto が必要です。

1. DATEV-Entwicklerportal(https://developer.datev.de)で、**OpenID Connect Authorization Code Flow** を使う Confidential アプリを作成します。リダイレクト URI は <your AnythingMCP URL>/api/mcp-oauth/callback に設定します(AnythingMCP Cloud の場合は https://cloud.anythingmcp.com/api/mcp-oauth/callback)。
2. アプリをサンドボックス API プロダクトの accounting:clients 2.0 と accounting:documents 2.0 にサブスクライブします。
3. クライアント ID を DATEV_CLIENT_ID に、クライアントシークレットを DATEV_CLIENT_SECRET にコピーします。シークレットは全体をコピーしてください。ポータルに表示されるのは一度きりです。
4. コネクターをインストールします。コネクターは DATEV のサンドボックスエンドポイント向けに設定済みで、DATEV が要求する HTTP Basic(client_secret_basic)でトークンエンドポイントに認証します。
5. コネクターのページで Authorize with Provider をクリックし、DATEV-Konto でログインします。サインインは一度だけで、リフレッシュトークンは暗号化されて保存されます。
6. datev_list_clients を実行します。DATEV-Konto のユーザーに割り当てられている Mandanten が、UUID、コンサルタント番号、クライアント番号、名前とともに一覧表示されます。

本番ではなくサンドボックス: DATEV が本番利用の承認審査を完了するまで、すべての DATEV アプリはサンドボックスで動作します。そのため、開発とテストはここで行います。サンドボックスは DATEV のテストデータを対象に動作します。DATEV がアプリの本番利用を承認したら、別の DATEV Online APIs コネクターを使用してください。同じ認証情報を使用し、接続先が本番エンドポイントになります。

スコープ: コネクターは datev:accounting:clients accounting:clients:read accounting:documents を要求します。openid は追加しないでください。これは発行者名であり、スコープではありません。

2 種類のクライアント ID: クライアントごとのツールはすべて clientId を受け取ります。これは datev_list_clients が返す Mandant の UUID です。DATEV_CLIENT_ID とは別のものです。DATEV_CLIENT_ID は OAuth アプリを識別するもので、すべての呼び出しで Bearer トークンとともに X-DATEV-Client-Id ヘッダーで送信されます。

読み取れる内容: Mandant のマスターデータ(コンサルタント番号、クライアント番号、名前、住所)、DATEV Unternehmen online(DUO)の書類アクセスを持つ Mandanten(有効な DUO サブスクリプションを持つクライアントのみが表示されるため、全件より少なくなる場合があります)、Mandant の書類タイプ(Belegtypen)、そして DUO のバージョンと DUO がアップロードで受け付けるファイル拡張子です。6 つのツールはすべて読み取り専用です。

ステップ 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 は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

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

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう — Gemini CLI が DATEV Online APIs (Sandbox) のツールを呼び出せるようになりました。

利用可能なツール

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクターのランディングページ
• Claude に接続する
• ChatGPT に接続する