Toggl MCP Server

🚀 从零开始使用 MCP Toggl Server（日本語版）

MCP Toggl Serverを使用することで、Toggl Trackとの統合が可能になり、開発作業を効率化することができます。このドキュメントでは、MCP Toggl Serverのインストール、開発ツールへの統合、テスト方法などについて説明します。

🚀 クイックスタート

このセクションでは、MCP Toggl Serverを迅速にセットアップするための手順を説明します。

✨ 主な機能

• Toggl Trackとの統合をサポートします。
• 詳細なインストールと設定ガイドを提供します。
• VS CodeとGitHub Copilotを通じた開発ツールの統合をサポートします。

📦 インストール

前提条件

• Python 3.11以上のバージョン
• Toggl Trackアカウント
• 依存関係管理に使用するuvがインストールされていること

環境変数の設定

mcp_toggl_server フォルダ内に .env ファイルを作成します。

EMAIL=your_toggl_email
PASSWORD=your_toggl_password

インストール手順

1. uvをインストールします。
   • MacOS/Linuxシステムの場合、以下のコマンドを実行します。

     curl -LsSf https://astral.sh/uv/install.sh | sh
     

   • Windowsシステムの場合、以下のコマンドを実行します。

     powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
     

2. ターミナルを再起動して、uvコマンドが有効になっていることを確認します。
3. コードリポジトリをクローンし、プロジェクトを設定します。

   git clone [repository-url]
   cd mcp_toggl_server
   uv venv
   uv pip install --all
   

💻 使用例

基本的な使用法

以下のコマンドを実行して、MCP Toggl Serverをテストします。

EMAIL=your_toggl_email PASSWORD=your_toggl_password mcp dev toggl_mcp_server.py

📚 ドキュメント

VS Code + GitHub Copilotの設定

1. MCPサーバーを設定します。 .vscode/mcp.json ファイルに以下の内容を追加します。

   "servers": {
     "toggl": {
       "type": "stdio",
       "command": "uv",
       "args": [
         "--directory",
         "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp_toggl_server",
         "run",
         "toggl_mcp_server.py"
       ],
       "envFile": "${workspaceFolder}/mcp_toggl_server/.env"
     }
   }
   

2. 設定を更新します。
   • /ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp_toggl_server を実際のパスに置き換えます。
   • 必要に応じて、command フィールドにuv実行ファイルの完全パスを指定できます。which uv（Mac/Linux）または where uv（Windows）を実行してパスを取得できます。
3. サーバーを有効にします。
   • MCPサーバー設定にマウスをホバーし、開始ボタンをクリックして、Copilotが利用可能なツールを検出できるようにします。
   • Agentモードに切り替えてCopilotを使用します。

その他のMCPクライアントの統合

1. Claude Desktopの場合は、MCPクイックスタートガイドを参照してください。
2. その他のMCPクライアントの場合は、それぞれのドキュメントを参照して設定してください。通常は、サーバーパスと環境変数を指定する必要があります。

🔧 技術詳細

このセクションでは、MCP Toggl Serverの技術的な詳細について説明します。

📄 ライセンス

（ここに具体的なライセンス契約内容を記載する必要があります）

付録：使用ガイド

Toggl MCP Serverの機能概要

• Toggl Trackとの統合をサポートします。
• 詳細なインストールと設定ガイドを提供します。
• VS CodeとGitHub Copilotを通じた開発ツールの統合をサポートします。

よくある質問

1. Togglアカウントを取得するにはどうすればよいですか？
   • Toggl の公式ウェブサイトにアクセスして登録し、ログインしてください。
2. uvのインストール中にエラーが発生した場合はどうすればよいですか？
   • ネットワーク接続が正常であることを確認するか、ミラーソースを変更してみてください。
3. .envファイルを設定する際に注意することは何ですか？
   • ファイルパスが正しいこと、および変数名がドキュメントと一致していることを確認してください。

連絡先

• 質問やフィードバックがある場合は、support@yourdomain.com までお問い合わせください。

その他のリソース

1. Toggl公式ウェブサイト
2. uvツールドキュメント
3. GitHub Copilotドキュメント