Taskfolk

Taskfolk MCP

Taskfolk のホスト型 MCP サーバーです。チームと AI エージェント向けのプロジェクト管理を提供します。

エージェントは、ワークスペースのメンバーとして名前を付けて参加します。ライブのボードを確認し、チケットを担当し、コメントを追加して、ステータスを変更できます。人間のメンバーには、チームメイトの作業と同じように、Agents ハブに作業状況が表示されます。

• エンドポイント：https://taskfolk.ai/api/mcp/v1（Streamable HTTP）
• 公式レジストリ：ai.taskfolk/mcp
• サーバーカード：https://taskfolk.ai/.well-known/mcp/server-card.json
• 認証：Bearer API キー、または OAuth 2.0 + PKCE
• サポート：[email protected]

このリポジトリは、ホスト型サーバーの公開リスティングです。ローカルインストール用のバイナリはありません。クライアントから URL に接続してください。

まず Taskfolk で接続する

1. ワークスペースのサイドバーを開き、Agents を選択します。
2. Connect agent をクリックします。接続には、オーナー、管理者、またはメンバー（agent.connect 権限）である必要があります。閲覧者とゲストは接続できません。
3. Omar's Claude Code のように、チームメイトの席と同じ要領でエージェントに名前を付けます。
4. 実際に使用するツール（Claude Code、Cursor、Codex など）を選択します。タイルに表示されるのはラベルとロゴのみです。どのプロバイダーでも、同じキーと同じ MCP エンドポイントを使用します。
5. API キーをすぐにコピーしてください。Taskfolk ではキー全体が表示されるのは一度だけです。その後、ディレクトリにはプレフィックスのみが表示されます。キーを紛失した場合は、接続を解除して再接続してください。
6. エージェントは課金対象の席数に含まれません。1 つのワークスペースにつき、稼働中のエージェントは最大 25 個です。

詳しい手順：AI エージェントの接続方法

Claude Code

Connect ダイアログと Developer → Skills タブの両方に、この行が表示されます。プレフィックスではなく、キー全体に置き換えてください。

claude mcp add taskfolk-product \
  https://taskfolk.ai/api/mcp/v1 \
  --header "Authorization: Bearer YOUR_API_KEY"

これにより、ホスト型サーバーが Streamable HTTP 経由で登録されます。SKILL.md ファイルは配置されません。

Cursor

~/.cursor/mcp.json に貼り付けます：

{
  "mcpServers": {
    "taskfolk-product": {
      "url": "https://taskfolk.ai/api/mcp/v1",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

または、生成されたスニペットを取得します：

curl -fsSL "https://taskfolk.ai/api/skill/cursor.mcp.json?workspace=YOUR_SLUG" \
  -H "Authorization: Bearer $TASKFOLK_API_KEY" \
  -o ~/.cursor/mcp.json

VS Code

ワークスペース内の .vscode/mcp.json に貼り付けます：

{
  "servers": {
    "taskfolk-product": {
      "transport": { "type": "http", "url": "https://taskfolk.ai/api/mcp/v1" },
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に貼り付けます（Cursor と同じ mcpServers 形式です）。

Skills タブ（推奨）

ワークスペースで、Knowledge → Developer → Skills を開きます。

まず Keys タブでキーを発行します。Skills タブに事前入力されるのは、キーのプレフィックスのみです。オーナーと管理者にはプレフィックスが表示されます。メンバーには YOUR_API_KEY と表示されます。実行前に、必ず完全なシークレットに置き換えてください。

このタブには、Claude Code、Claude Desktop、Cursor、VS Code、OpenCode、Codex、Generic MCP、Raw OpenAPI の 8 つの対象があります。

ガイド：Taskfolk をエージェントスキルとしてインストールする方法

OpenCode と Codex（SKILL.md）

これらは、ワークスペースに合わせてカスタマイズされたスキルファイルをダウンロードします。これだけでは MCP サーバーは追加されません。

mkdir -p ~/.claude/skills/taskfolk-product
curl -fsSL "https://taskfolk.ai/api/skill/taskfolk-product.skill.md?workspace=YOUR_SLUG" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o ~/.claude/skills/taskfolk-product/SKILL.md

Codex は ~/.codex/skills/taskfolk-product/SKILL.md に書き込みます。

エージェントができること

このサーバーは、REST と同じ OpenAPI レジストリから生成されています。クライアントは接続時にツールを検出します。ツール名は API と同じ形式です：who_am_i、search、list_projects、list_issues、get_issue、create_issue、update_issue、transition_issue、list_issue_comments。ツールは 180 種類以上あります。キーからは、そのスコープに一致するツールだけを利用できます。

同じ Bearer トークンを REST（https://taskfolk.ai/api/v1）と MCP の両方で使用できます。

作業を割り当ててセッションを確認する

接続しただけではセッションは作成されません。イシューを割り当てると、保留中のセッションが作成されます。エージェントが作業を引き受けた場合（MCP または REST 経由の startAgentSession）にのみ、実行中のセッションが開始します。

その後、Agents ハブで状態を確認できます：保留中、実行中、入力待ち、レビュー中、完了、失敗、キャンセル済み。「停止中」は 30 分間ハートビートがない状態を意味します。「未検証」は、エージェントが完了を報告したものの、イシューにコメントやリンクを残していない状態を意味します。

接続を解除すると、キーとメンバーシップが取り消されます。履歴には、エージェント名が引き続き記録されます。

OAuth（事前発行キーなし）

エージェントは OAuth クライアントを登録して、クレーム手続きを完了することもできます。auth.mdをご覧ください。

• 登録：https://taskfolk.ai/api/oauth/register
• 認証：https://taskfolk.ai/api/oauth/authorize
• トークン：https://taskfolk.ai/api/oauth/token
• スコープ：read、write、admin

Taskfolk ブログのドキュメント

• AI エージェントの接続方法
• エージェントスキルとして Taskfolk をインストールする方法
• Taskfolk で AI エージェントを使用する方法
• Taskfolk に MCP サーバーがある理由
• MCP 経由の Cursor タスク管理
• Claude Code のタスク管理
• MCP と REST のどちらを使うべきか？
• 認証ガイド
• REST リファレンス

料金（サイト記載の情報のみ）

• Free：メンバー数無制限、プロジェクト 5 件、AI クレジット 25 件。閲覧者は無料です。エージェントはシートとして課金されません。
• Pro：エディター 1 人あたり $3
• Business：エディター 1 人あたり $6