Taklo

Taklo MCP サーバー

Taklo の公開 MCP サーバーです。Taklo は、設置・メンテナンス業者向けのオールインワン業務ソフトウェアです。

AI エージェントは、Taklo に関する情報を調べたり、月額料金を計算したり、Taklo がどのような会計処理（請求書、VAT、Peppol）を行うのか、またどのパッケージとオプションで連携できるのかを確認したりできます。さらに、無料トライアルや折り返し連絡の依頼を準備できます。

エンドポイント

https://taklo.nl/mcp

• トランスポート： Streamable HTTP
• 認証： なし
• 費用： なし

接続

{
  "mcpServers": {
    "taklo": {
      "type": "http",
      "url": "https://taklo.nl/mcp"
    }
  }
}

手動で試す

application/json と text/event-stream の両方を受け入れる Accept ヘッダーを送信してください。このヘッダーがない場合、サーバーは -32000 Not Acceptable を返します。これは障害ではありません。

curl -s -X POST https://taklo.nl/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

/mcp への GET は 405 を返します。ステートレスな Streamable HTTP サーバーとして正しい動作です。再開するセッションはありません。ヘルスチェックには /mcp ではなく /health を使用してください。

ツール

ツール	機能	種類
taklo_info	Taklo に関する情報：料金、フェアユース、追加購入、無料トライアル、サービス	読み取り専用
taklo_prijs_berekenen	ユーザー数に応じた月額料金と、その内訳を計算します	読み取り専用
taklo_koppelingen	会計パッケージと、パッケージごとに自分で有効化できるかどうかを確認します	読み取り専用
start_gratis_proefperiode	14 日間のトライアル登録リンクを返します	依頼を記録
plan_terugbelmoment	折り返し連絡の依頼を記録します	依頼を記録

金額はすべて税抜き（B2B）です。各ツールの回答にも記載されています。金額を伝える際は、その旨も伝えてください。

権限の制限

どのツールも、アカウント、予約、申し込みを確定しません。

start_gratis_proefperiode はアカウントを作成しません。ツールは登録リンクを返し、ユーザーは自分のメールアドレスを使ってリンク先で手続きを完了します。これは意図的な仕様です。トライアルはアシスタントではなく、人が申し込むものだからです。クエリパラメーターを含め、リンクは変更せずに渡してください。これにより、Taklo は AI アシスタント経由の申し込みだと把握できます。

plan_terugbelmoment は依頼を記録します。自動で電話がかかることはなく、まず人が確認します。

この処理から外部への HTTP 呼び出しが行われることはなく、Taklo のデータベースにアクセスすることもありません。

データ

読み取りツールはライブクエリではなく、data/*.json のスナップショットを提供します。各回答には snapshotDatum が含まれており、情報がどれくらい古いか確認できます。スナップショットは Taklo の製品コードから生成され、定期的に更新されます。

最新の状態を保ちたいフォークでは、data/*.json を手動で変更しないでください。そうすると、taklo.nl に加えて別の情報源が生まれてしまいます。

taklo.nl で稼働しているサーバーとの違い

Taklo がホストするサーバーでは、書き込みを行う 2 つのツール呼び出しも内部ログテーブルに記録し、Taklo がエージェントの利用状況を確認できるようにしています。このログシンクは内部インフラであり、このリポジトリには含まれていません。こちらでは、同じログが stdout に出力されます。

呼び出し元のエージェントから見た動作は同一です。同じ 5 つのツール、同じ回答、同じ参照コードを使用します。

自分で実行する

npm install
npm start           # luistert op :8790

または Docker を使用します。

docker build -t taklo-mcp .
docker run -p 8790:8790 taklo-mcp

その後：

curl -s http://localhost:8790/health

server.js の ALLOWED_HOSTS で、受け入れる Host ヘッダーを指定します（DNS リバインディング対策）。独自ドメインの背後で実行する場合は、そのドメインを追加してください。

レート制限

IP アドレスごとに、読み取り操作は毎分 30 回、書き込み操作は毎分 5 回までです。バケットはプロセスのメモリ内にあります。

再利用する際はご注意ください。複数のユーザーに代わって呼び出すゲートウェイやプロキシが前段にある場合、それらのユーザー全員で 1 つのバケットを共有します。

ライセンス

MIT — LICENSE を参照してください。