インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、sevDesk をワンクリックで追加して、AI クライアント(Claude、ChatGPT、Copilot、Cursor)を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
Summary
sevDesk cloud bookkeeping for German SMBs and freelancers: contacts, invoices, vouchers (Belege), orders, parts and bank accounts. REST API v1, API-key auth — the key goes in a bare Authorization header, with no Bearer prefix.
こう聞いてみよう
sevDesk のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → sevDesk をクリック、認証情報を貼り付け、MCP API キーを発行 — 完了です。Docker も
git cloneもローカルサーバーも不要。
sevDesk + Gemini
sevDesk cloud bookkeeping for German SMBs and freelancers: contacts, invoices, vouchers (Belege), orders, parts and bank accounts. REST API v1, API-key auth — the key goes in a bare Authorization header, with no Bearer prefix.
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
SEVDESK_API_KEY
ステップ 1 — 認証情報を取得
Getting a key
- Sign in to sevDesk and open Einstellungen → Benutzer → (your user) → API-Token.
- Copy the token into
SEVDESK_API_KEY. It belongs to one user in one client (Mandant) and inherits that user's permissions — create a dedicated API user with read rights if the agent should not be able to write.
The Authorization header has no scheme. sevDesk expects the raw token (Authorization: abc123…), not Bearer abc123…. This adapter sends it that way; if you build a custom connector against sevDesk by hand, that is the single most common reason for a 401.
…(continued in the in-app connector instructions)
ステップ 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 にコネクタを追加
Gemini CLI は ~/.gemini/settings.json (Windows は %APPDATA%\gemini\settings.json) から MCP サーバを読み込みます。追加:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp",
"headers": { "Authorization": "Bearer YOUR_MCP_API_KEY" }
}
}
}
- AnythingMCP の Profile → MCP API Keys → New Key で MCP API key を取得。
- ファイルを保存し
geminiを再起動。 - Gemini CLI で
/mcpを実行 —sevDeskが利用可能として表示されます。 - Vertex AI Studio: 同じ Bearer ヘッダーで
https://cloud.anythingmcp.com/mcpをリクエストのtools配列に渡してください。
利用可能なツール
| Tool | What it does |
|---|---|
sevdesk_list_users | List the sevDesk users in this client, with their names and e-mail addresses |
sevdesk_list_contacts | List contacts (customers, suppliers, partners) |
sevdesk_get_contact | Read one contact by its numeric sevDesk id, with its category, customer number, tax settings and default payment terms |
sevdesk_list_invoices | List outgoing invoices, newest first |
sevdesk_get_invoice_positions | Read the line items (Positionen) of one invoice: article, quantity, unit price, tax rate and the resulting net and gross sums |
sevdesk_list_vouchers | List vouchers (Belege) — incoming supplier invoices and receipts |
sevdesk_list_orders | List orders and quotations (Aufträge und Angebote) |
sevdesk_list_parts | List parts (Artikel) from the sevDesk product catalogue with their price, stock level, unit and tax rate |
sevdesk_list_check_accounts | List the bank and cash accounts (Kassen und Bankkonten) configured in sevDesk, with their current balance and import type |
sevdesk_list_transactions | List bank transactions on one check account, so unpaid invoices can be matched against money that actually arrived |
sevdesk_create_contact | Create a new contact |
FAQ
Gemini 1.5 Pro / 2.x は MCP をサポートしますか? はい — Gemini CLI ≥ 0.4 と Vertex AI tools API は Bearer ヘッダー付きの httpUrl MCP コネクタを受け入れます。
次のステップ
このガイドは役に立ちましたか?