mite

mite-mcp-server

English · Deutsch

Claude に mite の時間追跡について質問できます。「今年、月ごとに各プロジェクトに何時間費やし、その結果いくらの収益がありましたか？」と聞けば、モデルが何百件もの記録を足し合わせるのではなく、mite 自身が作成したレポートから回答が得られます。

非公式です。mite GmbH との提携や同社による承認はありません。

このサーバーを使う理由

• すぐに使えるレポート。 mite がサーバー側でグループ化（group_by）するため、1 年分のデータも 1 回のリクエストで取得でき、回答も簡潔です。
• デフォルトで安全。 読み取り専用で起動します。書き込みツールはモードを有効にした場合にのみ利用でき、許可リストでさらに対象を絞り込めます。モードと許可リストの対象外のツールは、エージェントに表示されることもありません。
• API キーは自分で管理。 API キーは環境変数からのみ取得し、ヘッダーとして送信します。すべてのエラーメッセージから削除され、ログに記録されることもありません。

ツール

ツール	モード	機能
mite_whoami	読み取り専用	アカウント、ユーザーとロール、サーバーモード、有効なツール
mite_report_projects_by_month	読み取り専用	期間ごとのプロジェクト別・月別の時間数と売上。顧客、プロジェクト、サービス、ユーザー、請求対象で絞り込み可能
mite_report	読み取り専用	1～3 個のグループ（顧客、プロジェクト、サービス、ユーザー、日、週、月、年）ごとの時間数、売上、構成比。同じ絞り込み条件を使用可能
mite_report_budget	読み取り専用	プロジェクトの全期間における予算、消化額、残額、使用率。時間は分単位、通貨は通貨単位のセントで表示
mite_report_billable_ratio	読み取り専用	期間ごとの請求対象・請求対象外の時間数と請求対象の割合（％）。顧客、プロジェクト、ユーザー、月ごとの表示も可能
mite_list_time_entries	読み取り専用	期間内の個別の時間エントリーを新しい順に表示。絞り込み、limit／page、has_more
mite_get_time_entry	読み取り専用	ID で時間エントリーを 1 件取得
mite_tracker_status	読み取り専用	トラッカーが実行中かどうか、および対象のエントリー
mite_list_customers	読み取り専用	顧客。アクティブまたはアーカイブ済み（archived: true）
mite_list_projects	読み取り専用	顧客と予算を含むプロジェクト。アクティブまたはアーカイブ済み
mite_list_services	読み取り専用	サービス。アクティブまたはアーカイブ済み
mite_list_users	読み取り専用	ユーザーとロール（メールアドレス、料金は含まれません）。アクティブまたはアーカイブ済み
mite_create_time_entry	書き込み	時間エントリーを作成します。dry_run: true を指定するとプレビューを表示し、書き込みは行いません
mite_update_time_entry	書き込み	時間エントリーのフィールドを変更します（ロックされた項目については下記を参照）。dry_run: true を指定すると現在値と新しい値を表示し、書き込みは行いません
mite_start_tracker	書き込み	時間エントリーのトラッカーを開始します
mite_stop_tracker	書き込み	時間エントリーのトラッカーを停止します
mite_delete_time_entry	書き込み	確認トークンを使って 2 段階で時間エントリーを削除します（下記を参照）。ロックされたエントリーについては「ロックされたエントリー」を参照
mite_create_customer, mite_create_project, mite_create_service	管理	顧客、プロジェクト、またはサービスを作成します。dry_run: true を指定するとプレビューを表示し、書き込みは行いません
mite_update_customer, mite_update_project, mite_update_service	管理	フィールドを変更します。archived: true でアーカイブし、archived: false で復元します。dry_run: true を指定すると書き込みは行いません
mite_delete_customer, mite_delete_project, mite_delete_service	管理	確認トークンを使って 2 段階で削除します（下記を参照）。時間エントリーが存在する場合など、mite による削除拒否はエラーとして返されます

確認トークンを使った削除

mite_delete_time_entry と3つのマスターデータ削除ツールは、最初の呼び出しでは削除を実行しません。

1. id を指定して呼び出します（または dry_run: true を指定します）。エントリのプレビューと confirm_token が返されます。削除は実行されません。
2. 同じ id と confirm_token を指定して再度呼び出します。その後にのみ削除されます。

トークンはツールとその引数に紐づき、有効期間は5分で、1回のみ使用できます。また、実行中のサーバープロセスのみが把握しているため、再起動すると無効になります。

MCP クライアントがエリシテーションに対応している場合、2回目の呼び出し（および force: true とトークンを指定したすべての呼び出し）では、削除または強制実行される内容の短い要約を示して、人間に追加で確認を求めます。人間が承認した場合にのみ実行されます。拒否またはキャンセルした場合、mite には何も送信されず、トークンは期限切れになるまで未使用のままです。エリシテーションに対応していないクライアントには確認を求めません。トークンのみで処理されます。

クライアントの対応状況（2026年10月28日確認）： Claude Desktop はまだエリシテーションを提供していないため、ダイアログは表示されません。そこでの削除はトークンフローのみを使用します。クライアントがエリシテーションへの対応を発表すれば、このサーバーの新しいリリースを待たずに追加の確認が適用されます。

ロックされたエントリ

ロックされた時間エントリは、デフォルトでは変更も削除もできません。mite は 423 を返し、ツールは「locked」エラーを返します。423 が返された後でも、force が自動的に設定されることはありません。

admin モードでのみ、mite_update_time_entry と mite_delete_time_entry は追加で force: true を受け付けます。force: true を指定する呼び出しでは、更新の場合も必ず confirm_token が必要です。最初の呼び出し（または dry_run: true）では、エントリがロックされていることを示すプレビューとトークンが返されます。同じ引数、force: true、トークンを指定した2回目の呼び出しでのみ実行されます。read-only モードと write モードでは、このパラメーターは入力スキーマに含まれません。

ツールの追加（レポートの拡充）は予定されています。詳しくはアーキテクチャ上の決定をご覧ください。

技術的な知識がなくてもインストールできます（Claude Desktop）

1. 最新リリースから mite-mcp-server.mcpb をダウンロードします。
2. ファイルをダブルクリックします。Claude Desktop が開き、拡張機能のインストールを提案します。
3. 設定を入力し、拡張機能を有効にします。

設定	意味
mite-Account	mite のアドレスに含まれる名前です。https://example.mite.de の場合は example を入力します。
API-Key	個人用の mite API キーです。Claude Desktop が安全に保存し、マスクして表示します。
Zeiteinträge schreiben erlauben	オフ（デフォルト）：読み取り専用です。オン：時間記録の作成、変更、削除、タイマーの開始と停止ができます。
Stammdaten verwalten	オフ（デフォルト）です。オン：顧客、プロジェクト、サービスを管理できます。時間記録の書き込みも含まれます。
Erlaubte Werkzeuge	任意の項目です。ツール名をカンマ区切りで指定します。空欄の場合、スイッチで許可されたすべてのツールが対象です。

JSON、環境変数、Node.js のインストールは不要です。Claude Desktop は内蔵の Node.js でバンドルを実行します。mite アカウントで API アクセスを有効にし（mite のユーザー設定で設定します）、そこで API キーを取得する必要があります。mite のユーザーの大半がドイツ語を使うため、設定はドイツ語です。

設定を後から変更するには、Claude Desktop → Settings → Extensions → mite を開きます。設定を変更した場合、拡張機能をいったんオフにして再度オンにするか、Claude Desktop を再起動するまで変更は反映されません。それまでは、実行中のサーバーは以前のスイッチ設定を使い続けます。Claude に mite_whoami を呼び出すよう頼むと、サーバーが実際に実行中のモードを確認できます。同じ場所で、上記のスイッチに加えて、個々のツールのオン／オフも切り替えられます。上記のスイッチは、そもそも利用可能になるツールを決定します。

手動セットアップ（Claude Desktop、開発者向け）

必要なもの：Node.js 22 以降、API アクセスを有効にした mite アカウント（mite のユーザー設定で有効にします）、およびそこで取得した API キー。

サーバーを claude_desktop_config.json（macOS の場合：~/Library/Application Support/Claude/）に追加し、Claude Desktop を再起動します。

{
  "mcpServers": {
    "mite": {
      "command": "npx",
      "args": ["-y", "mite-mcp-server"],
      "env": {
        "MITE_ACCOUNT": "your-account",
        "MITE_API_KEY": "your-api-key"
      }
    }
  }
}

次のように尋ねてみてください。「今年のプロジェクト別・月別の作業時間と売上を表示してください。」

設定

変数	必須	意味
MITE_ACCOUNT	はい	アカウント名です。https://<account>.mite.de のサブドメインを指定します。
MITE_API_KEY	はい	個人用の mite API キーです。
MITE_MODE	いいえ	read-only（デフォルト）、write、または admin
MITE_ALLOW_WRITE	いいえ	true = モード write です。バンドルのスイッチで設定します。MITE_MODE の代わりに使用できます。
MITE_ALLOW_ADMIN	いいえ	true = モード admin です。バンドルのスイッチで設定します。MITE_MODE の代わりに使用できます。
MITE_TOOLS	いいえ	許可リストをカンマ区切りで指定します。例：mite_report_projects_by_month

MITE_MODE または2つのスイッチのいずれかを使用してください。MITE_MODE と、true に設定されたスイッチを併用すると、サーバーは起動を拒否します。値には true／false（または 1／0、yes／no、on／off）を指定できます。

mite は引き続き、すべての呼び出しをキーのロールに照らして確認します。サーバーは権限を制限することはできますが、拡張することはできません。

開発

npm ci
npm run check   # lint, format, typecheck, tests with coverage, build

CONTRIBUTING.md とアーキテクチャに関する決定を参照してください。

License

MIT © Stefan Jacomeit — www.jacomeit.de