Teamwork

🚀 チームワーク協力ガイド

Teamwork MCP（マシン通信プロトコル）プロジェクトは、Teamwork.com APIと統合するための強力なツールです。コマンドラインや他のMCPクライアント（Cursorなど）を通じて、Teamworkプロジェクトと簡単にやり取りできます。このドキュメントでは、このツールのインストール、設定、使用方法を案内します。

🚀 クイックスタート

このドキュメントでは、Teamwork MCPツールのインストール、設定、使用方法を詳しく説明します。

📦 インストール

NPXを使用する（推奨）

最も簡単な使用方法は、NPXを通じて実行することです。

npx teamwork-mcp

設定オプションを渡す必要がある場合は、以下のようにします。

npx teamwork-mcp --domain=your-company --user=your-email@example.com --pass=your-password

アプリケーションをビルドする

手動でビルドする必要がある場合は、以下のコマンドを実行します。

npm run build

これにより、TypeScriptコードがMCPサーバーで使用できるファイルにコンパイルされます。

✨ 主な機能

Teamwork MCPは、複数のチーム協力モードをサポートしており、コマンドラインや他のMCPクライアントを通じてプロジェクトとやり取りできます。以下は主な機能のリストです。

• プロジェクトを取得する：getProjects
• タスクを取得する：getTasks
• タスクを作成する：createTask
• タスクを更新する：updateTask
• タスクを削除する：deleteTask
• プロジェクトを関連付ける：associateProject

📚 ドキュメント

Teamworkプロジェクトの設定

設定ファイルを使用する

プロジェクトのルートディレクトリに.teamworkファイルを作成し、以下の内容を記述します。

PROJECT_ID = あなたのTeamworkプロジェクトID

これにより、MCPが自動的にあなたのプロジェクトを認識できるようになります。

使用方法

MCPサーバーとして実行する

MCPサーバーモードで実行するには（Cursorや他のアプリケーションと統合するため）、以下のコマンドを実行します。

node C:/your-full-path/build/index.js

または、コマンドラインで資格情報を渡すこともできます。

node C:/your-full-path/build/index.js --teamwork-domain=your-company --teamwork-username=your-email@example.com --teamwork-password=your-password

Cursor（および他のMCPクライアント）への設定

バージョン0.47以前のCursorの場合

1. Cursor設定 > 機能 > MCPを開きます。
2. 「+ 新しいMCPサーバーを追加」をクリックします。
3. サーバー名を入力します（例：「Teamwork API」）。
4. 「stdio」を伝送タイプとして選択します。
5. コマンドボックスに以下を入力します：npx @vizioz/teamwork-mcp --domain your-company --user your-email@example.com --pass your-password
6. 「追加」をクリックします。

バージョン0.47以降のCursorの場合

設定ファイルに以下の内容を追加します。

    "Teamwork": {
      "command": "npx",
      "args": [
        "-y",
        "@vizioz/teamwork-mcp",
        "--domain",
        "yourdomain",
        "--user",
        "youruser@yourdomain.com",
        "--pass",
        "yourPassword"
      ]
    }

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEファイルを参照してください。

⚠️ 免責事項

このプロジェクトはTeamwork.comとは一切関係ありません。「Teamwork」という名称は、Teamwork.com APIとの互換性を説明するためにのみ使用されており、何らかの形の支援や推薦を意味するものではありません。