概要
DATEV Online APIs のサンドボックス環境です。DATEV のテストデータを使って、会計の Mandanten(クライアント)、書類タイプ、DUO のバージョンメタデータを読み取れます。開発とテストの間はこちらを使用してください。DATEV が本番利用を承認するまで、すべての DATEV アプリはサンドボックスで動作させる必要があります。本番環境と同じ OAuth2 Authorization Code + PKCE フローで、接続先が DATEV のサンドボックスエンドポイントになります。
ガイド付きセットアップ
DATEV Online APIs を Microsoft Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで DATEV Online APIs を接続して、MCP URL を Microsoft Copilot に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
DATEV Online APIs (Sandbox) のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストールは不要ですか?cloud.anythingmcp.com をそのままご利用ください。 サインインして Connectors → DATEV Online APIs (Sandbox) をクリックし、認証情報を貼り付けて MCP API キーを発行するだけです。Docker も
git cloneもローカルサーバーも不要です。
DATEV Online APIs (Sandbox) + Microsoft Copilot
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 が必要です。
- 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)。 - アプリをサンドボックス API プロダクトの accounting:clients 2.0 と accounting:documents 2.0 にサブスクライブします。
- クライアント ID を
DATEV_CLIENT_IDに、クライアントシークレットをDATEV_CLIENT_SECRETにコピーします。シークレットは全体をコピーしてください。ポータルに表示されるのは一度きりです。 - コネクターをインストールします。コネクターは DATEV のサンドボックスエンドポイント向けに設定済みで、DATEV が要求する HTTP Basic(
client_secret_basic)でトークンエンドポイントに認証します。 - コネクターのページで Authorize with Provider をクリックし、DATEV-Konto でログインします。サインインは一度だけで、リフレッシュトークンは暗号化されて保存されます。
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 — Microsoft Copilot にコネクターを追加する
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。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 を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
- エージェントの Test ウィンドウで試します。
DATEV Online APIs (Sandbox)のツールが必要になる依頼をしてみましょう。 - 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://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。
利用可能なツール
| Tool | What it does |
|---|---|
datev_list_clients | accounting-clients v2 のマスターデータプロダクトから、DATEV-Konto のユーザーに割り当てられている DATEV 会計の Mandanten(クライアント)を一覧表示します |
datev_get_client | accounting-clients v2 から、1 つの Mandant のマスターデータ(コンサルタント番号/クライアント番号、名前、住所)を取得します |
datev_documents_list_clients | accounting-documents v2 プロダクトを通じて、DATEV Unternehmen online(DUO)の書類アクセスを持つ Mandanten のサブセットを一覧表示します |
datev_get_documents_client | accounting-documents v2 プロダクトが公開する 1 つの Mandant の基本データ(DUO ビュー。accounting-clients のマスター… |
datev_list_document_types | DATEV Unternehmen online 上で Mandant に設定されている書類タイプ(Belegtypen)を一覧表示します。書類をアップロードする前に、知っておく必要があります… |
datev_get_duo_version | 指定した Mandant の DATEV Unternehmen online(DUO)のバージョンと、書類アップロードで許可されているファイル拡張子を取得します |
FAQ
どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。
何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント（ライセンスまたは試用版）が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。
エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?