DokuTrak

dokutrak-mcp

DokuTrak 向けのオープンな MCP コネクターです： エージェントに書類の催促を任せましょう。

DokuTrak は、お客様に代わってクライアントから書類を集めます。依頼を送ると、クライアントはセキュアなリンクからファイルをアップロードし、ファイルが確認され、返信のないクライアントにはリマインダーが送られます。このコネクターを使うと、普段使っているエージェント内でこの流れを進められるため、「Dupont のファイルは今どうなっていますか？」という質問にも、Claude を離れずに答えられます。

このコネクターは、DokuTrak API を利用する、薄型のステートレスなクライアントです。渡された Agent Connection を保持しますが、ディスクには何も保存せず、キャッシュも保持せず、ルールを複製することもありません。エージェントに許可される操作と許可されない操作はサービスによって決定され、拒否された場合はサービス独自の説明を含むツールエラーが返されます。

インストール

DokuTrak のワークスペースと、DokuTrak アプリの Settings → Connect an agent から発行する Agent Connection が必要です。この画面には、キーがあらかじめ設定された、すぐに貼り付けられる構成が表示されます。以下の手順は、それと同じ設定を手動で行う方法です。

キーは環境変数 DOKUTRAK_API_KEY から読み取られます。コマンドラインから取得することはありません。

Claude Desktop へのインストール（ワンクリック）

1. MCP Bundle としてパッケージ化されたコネクター dokutrak.mcpb をダウンロードします。
2. ファイルをダブルクリックするか、Claude Desktop の Settings → Extensions にドラッグします。
3. Install をクリックし、求められたら Agent Connection キーを貼り付けます。Claude Desktop はキーをマスクして安全に保存し、DOKUTRAK_API_KEY としてコネクターに渡します。

このバンドルにはコネクターのコピーが含まれており、Claude Desktop に組み込まれている Node.js で実行されます。npx も、編集が必要な構成ファイルもありません。クローンからは npm run bundle で同じファイルをビルドできます。

Claude Desktop への手動インストール

構成ファイルを開きます。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

mcpServers の下にサーバーを追加します（ファイルが空の場合はオブジェクトを作成します）。

{
  "mcpServers": {
    "dokutrak": {
      "command": "npx",
      "args": ["-y", "dokutrak-mcp"],
      "env": { "DOKUTRAK_API_KEY": "dk_live_…" }
    }
  }
}

Claude Desktop を再起動します。新しい会話のツールメニューに DokuTrak のツールが表示されます。

Claude Code

claude mcp add dokutrak -e DOKUTRAK_API_KEY=dk_live_… -- npx -y dokutrak-mcp

その後、Claude Code 内で /mcp を実行すると、dokutrak とそのツールが一覧表示されます。

Claude Code プラグイン：税務シーズンの書類催促

/plugin install dokutrak --marketplace Crackx17/dokutrak-mcp

このプラグインは、ホスト型コネクター（初回使用時に DokuTrak にサインインします）と tax-season-document-chase スキルを追加します。Claude にクライアントのリストを渡すと、申告タイプ（W-2、1099、Schedule C、賃貸物件、K-1、退職者など）ごとに各クライアントのチェックリストを作成し、確認用に全件をまとめて表示します。その後、DokuTrak で確認するためにクライアントごとに依頼を1件ずつ準備し、依頼を送信して、後から不足している書類があるクライアントを報告します。確認なしに送信されることはありません。

claude.ai と ChatGPT（ホスト型）

https://app.dokutrak.com/api/mcp をカスタムコネクターとして追加します。OAuth の手順で DokuTrak にサインインするか、アカウントを作成します。ホスト型コネクターは依頼を準備し、DokuTrak で確認した後にのみ送信して、進捗を追跡します。ファイルの内容が返されることはありません。ファイルのダウンロードには、このローカルコネクターを使用します。設定方法： dokutrak.com/connectors。

npm リリース前にクローンから利用する場合

git clone https://github.com/Crackx17/dokutrak-mcp.git
cd dokutrak-mcp
npm ci && npm run build

その後、npx の代わりに、ビルドしたファイルをクライアントに指定します。

{
  "mcpServers": {
    "dokutrak": {
      "command": "node",
      "args": ["/path/to/dokutrak-mcp/dist/cli.js"],
      "env": { "DOKUTRAK_API_KEY": "dk_live_…" }
    }
  }
}

または、Claude Code の場合：claude mcp add dokutrak -e DOKUTRAK_API_KEY=dk_live_… -- node /path/to/dokutrak-mcp/dist/cli.js。

スキル

skills/dokutrak/SKILL.md では、日常的な3つの使い方（クライアントに書類を依頼する、依頼の状況を確認する、却下されたファイルを催促する）と、接続方法をエージェントに教えます。DokuTrak ユーザーがコネクターと一緒にインストールするものです。

npx skills add Crackx17/dokutrak-mcp        # the open agent-skills installer
# or by hand, for Claude Code / Claude Desktop:
cp -r skills/dokutrak ~/.claude/skills/dokutrak

Configuration

Variable	Required	Default	Meaning
DOKUTRAK_API_KEY	yes	—	Agent Connection。Settings → Connect an agent で取得します。
DOKUTRAK_API_URL	no	https://app.dokutrak.com/api	API のベース URL です。末尾は /api で、コネクターが /v1 を追加します。

Tools

4 つのツールで、依頼、催促、確認、収集を一巡できます。

create_request

Document Request を作成して送信するまでを、1 回の呼び出しで行います。作成したまま未送信の状態で残ることはありません。 クライアントのメールアドレス、期限（YYYY-MM-DD または ISO 形式の日時）、必要な書類のチェックリストを指定します。タイトルとメッセージは任意です。メールはここで指定した宛先にのみ送信されます。クライアントはメールに記載された安全なリンクからアップロードします。内部では DokuTrak アプリと同じ 2 段階の処理を行います。まず sendEmail: false で作成し、次に送信します。送信に失敗した場合、エラーには作成されたリクエストが示され、そのリクエストはダッシュボードに表示されたままになります。

あなたの承認なしに送信されることはありません。 実際のクライアント宛てのメールは取り消せないため、このツールはエージェントに宛先、期限、チェックリスト、メッセージをあなたに提示し、あなたの確認を待つよう指示します。また、クライアントが呼び出しのたびにあなたに確認するようフラグも設定されています。Claude Code は自動モードやバイパスモードでも毎回プロンプトを表示し、Claude Desktop は常に承認を必要とするツールとして扱います。これらのフラグを無視するクライアントの場合は、エージェントへの指示だけが頼りになります。

request_replacement

リクエスト内で却下されたファイルについてクライアントに催促します。ファイルにフラグを付け、リクエストをクライアント待ちに戻し、自動リマインダーのスケジュールに再び組み込みます。この呼び出し自体はメールを送信しません。メールを送信するのはリマインダーです。DokuTrak には、ダッシュボードからの場合も含め、クライアントにすぐメールを送信する方法はありません。任意のメッセージはリクエストの監査証跡に記録されますが、クライアントには送信されません。却下されたファイルがないリクエストには対応しません。

get_request

Document Request の状況を 1 回の呼び出しで確認できます。ステータス、チェックリスト、収集済みのすべてのファイルとその判定（承認済み、審査担当者の理由付きで却下、または保留中）、およびリマインダーの状態を返します。request_id、またはタイトル、クライアントの名前、メールアドレスに一致する検索語 search を指定します。複数のリクエストが一致した場合、ツールは候補を返し、ID の指定を求めます。

download_documents

リクエストの収集済みファイルをすべて、1 つの zip アーカイブとして取得します。アーカイブはリンクではなく、ツールの結果にバイナリコンテンツとして埋め込まれて返されます（base64 blob と application/zip を含む MCP リソース）。API に zip 用の短縮リンクエンドポイントがなく、コネクターはディスクに何も書き込みません。バイト列をどう扱うかは、ブラウザーからダウンロードした場合と同様、担当者側で決定します。アーカイブが大きいと結果も大きくなるため、呼び出す前に get_request で書類が届いていることを確認してください。

このコネクターでできないこと

書類を承認するか却下するかは、DokuTrak ダッシュボードであなたが判断します。ここにあるツールで判断することはできず、どのコネクターからの要求であっても、サービスは Agent Connection による操作を拒否します。請求、ワークスペースの設定、API キーの管理についても同様です。

DokuTrak で Agent Connection を無効にすると、次の呼び出しから有効になります。コネクターはサービスからの 401 を返し、それ以外は返しません。

プライバシーポリシー

このコネクターはお使いのマシン上で動作し、設定済みの Agent Connection を使用して、1 つのサービス、DokuTrak API（https://app.dokutrak.com/api、または DOKUTRAK_API_URL に設定した URL）とのみ通信します。ツールに必要な情報（作成するリクエスト、検索する ID または検索語句）を送信し、回答をエージェントに中継します。ディスクには何も書き込まず、キャッシュやログを保持せず、DokuTrak やその他の相手にテレメトリーや分析データを送信することもありません。

送信される情報はすべて、DokuTrak プライバシーポリシーに基づいて DokuTrak によって処理されます。このポリシーでは、収集される情報、その使用方法と保存方法、共有先のサブプロセッサー、保持と削除、お客様の権利について説明しています。お問い合わせ先：[email protected]。セキュリティに関する問題の報告先：[email protected]。

開発

npm ci
npm run check   # typecheck, build, tests
npm test        # tests alone

テストは MCP の境界におけるコントラクトテストです。実際の MCP クライアントと実際のサーバーを、公式 SDK のトランスポートを使ってメモリー内で接続し、fetch で HTTP を記録済みの応答に置き換えます。関数ではなくツールを呼び出し、DokuTrak アカウントもネットワークも必要とせずに実行されます。

ステージング実行

リリース前に、ビルド済みバイナリを実際のワークスペースで一度、stdio 経由の実際の MCP クライアントから実行します。処理は、作成 → 追跡 → 読み取り → 収集 → 取り消し → 401 の順に進みます。これはリリース PR に貼り付ける記録であり、CI のチェックではありません（ブロッキングチェックではサードパーティーを呼び出しません）。Agent Connection に対してサービスが拒否する操作、アップロードしたファイルの拒否とキーの取り消しのため、2 回一時停止します。

npm run build
DOKUTRAK_API_KEY=dk_live_… [email protected] npm run staging

実際の Document Request が作成され、実際のメールが STAGING_RECIPIENT_EMAIL に送信されます。トランスクリプトは staging-run-<timestamp>.md（git で無視されるファイル）に保存されます。キーがそこに書き込まれることはありません。

MCP バンドル

npm run bundle は mcpb/server/index.cjs（すべての依存関係をインライン化したコネクター）をビルドして起動し、package.json のバージョンにおいて、mcpb/manifest.json で宣言されたツールだけが一覧表示されることを確認した後、マニフェストを検証し、公式の mcpb CLI で dokutrak.mcpb をパッケージ化します。CI ではすべてのプルリクエストで実行され、リリースワークフローでは各タグの GitHub リリースに dokutrak.mcpb が添付されます。ツールの構成やバージョンを変更した場合は、mcpb/manifest.json も更新します。

リリース

package.json および SERVER_VERSION と一致するタグ vX.Y.Z によって、.github/workflows/release.yml が実行されます。npm run check、npm publish（GitHub の OIDC トークンによる信頼されたパブリッシング。プロベナンスを添付）、続いて MCP Registry への io.github.Crackx17/dokutrak-mcp の登録を行います。これは package.json の mcpName であり、レジストリは公開された tarball と照合して確認します。ワークフローを手動で実行すると --dry-run が行われ、何も公開されません。

ライセンス

MIT。