Teamwork MCP

🚀 チームワークツール - チームワークMCPサーバー

チームワークMCPサーバーは、Teamwork プラットフォーム用に設計された統合モジュール（MCP）です。Cursorなどの他のツールとの相互作用に使用されます。このMCPを通じて、Teamwork上で直接様々なタスクや操作を実行できます。

🚀 クイックスタート

📦 インストール

NPXを使用する方法（推奨）

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

npx teamwork-mcp

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

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

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

コードを自分でビルドしたい場合は、以下のコマンドを実行します。

npm run build

このコマンドは、TypeScriptコードを直接実行可能なMCPサーバーにコンパイルします。

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

他のアプリケーションと統合してMCPサーバーとして実行する場合、.envファイルまたは環境変数を使用してユーザー名、パスワード、URLを設定することを想定しています。

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

省略形を使用することもできます。

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

MCPチェックツールを使用する方法

デバッグのためにMCPチェックツールを実行するには、以下のコマンドを実行します。

npm run inspector

💻 使用例

Teamworkプロジェクトの設定

現在のソリューションをTeamworkプロジェクトに関連付けるには、以下の内容の .teamwork ファイルを作成します。

PROJECT_ID = YourTeamworkProjectID

この設定ファイルは、特定のTeamworkプロジェクトを識別するために使用され、将来的にはさらに詳細な情報が追加される可能性があります。設定が完了すると、MCPはあなたのTeamworkプロジェクトを識別し、現在のソリューションに関連付けることができ、プロジェクトとタスクを取得するために必要なAPI呼び出しの数を減らすことができます。

Cursor（および他のMCPクライアント）に追加する方法

バージョン0.47未満の場合：

1. Cursor設定 > 機能 > MCPを開きます。
2. "+ 新しいMCPサーバーを追加" をクリックします。
3. サーバー名（例："Teamwork API"）を入力します。
4. 伝送タイプとして "stdio" を選択します。
5. コマンドフィールドに npx @vizioz/teamwork-mcp を入力し、必要なコマンドライン引数（ドメイン名、ユーザー名、パスワード）を追加します。
   • ツールフィルターオプションをここで追加することができます：--allow=getProjects,getTasks または --deny=deleteTask
6. "追加" をクリックします。

バージョン0.47以上の場合：

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

許可または拒否のパラメーターを追加する必要がある場合は、以下のようにします。

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

これで、Teamwork MCPツールがCursorエージェントのコンポーザーで使用可能になります。

📄 ライセンス

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

⚠️ 免責事項

このプロジェクトはTeamwork.comとは関係がなく、サポートやスポンサーを受けていません。パッケージ名 (@vizioz/teamwork-mcp) の "Teamwork" という名前は、Teamwork.com APIとの互換性を示すためにのみ使用されています。