DATEV Sandbox MCPサーバー

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

DATEV Online APIs (Sandbox)

DATEV Online APIs のサンドボックス環境です。DATEV のテストデータに対して、会計の Mandanten（クライアント）、ドキュメントタイプ、DUO のバージョンメタデータを読み取れます。DATEV が本番利用を承認するまで、新しい DATEV アプリはすべてサンドボックスで動作させる必要があるため、構築とテストの際にご利用ください。本番環境と同じ OAuth2 Authorization Code + PKCE フローを、DATEV のサンドボックスエンドポイントに向けて使用します。

セットアップ

セットアップには約 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 です。OAuth アプリを識別する DATEV_CLIENT_ID とは別のもので、DATEV_CLIENT_ID はすべての呼び出しで Bearer トークンとともに X-DATEV-Client-Id ヘッダーで送信されます。

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

前提条件: DATEV_CLIENT_ID、DATEV_CLIENT_SECRET

コネクターをローカルにインストールする

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

http://localhost:3000/connectors/store を開き、DATEV Online APIs (Sandbox) を選択して、前提条件に記載した環境変数を貼り付けます。

利用可能なツール

次のステップ

• Claude に接続する
• ChatGPT に接続する