← ガイドに戻る

MCP サーバー

対応する MCP クライアントから、Taskly の課題を確認・操作できます。

最初に知っておきたいこと

Taskly は、接続用プログラム taskly-mcp を経由して利用します。https://mcp.taskly.iy0306.com を「リモート MCP サーバー」として直接追加する方式ではありません。

接続までの流れ

  1. 1

    接続用プログラムをインストール

    macOS・Linux のターミナルで、次のコマンドを実行します。

    curl -fsSL https://cdn.taskly.iy0306.com/docs/mcp/clients/install.sh | bash

    Windows は PowerShell で次の 2 行を実行します。

    Invoke-WebRequest https://cdn.taskly.iy0306.com/docs/mcp/clients/install.ps1 -OutFile install.ps1
    .\install.ps1
  2. 2

    MCP トークンを発行

    設定 → MCP を開き、「トークンを発行」を選びます。トークンは発行直後の一度しか表示されないため、その場でコピーしてください。

  3. 3

    MCP クライアントへ設定を追加

    クライアントの MCP 設定へ次の内容を追加し、<issued token> を発行したトークンに置き換えます。設定ファイルの場所はクライアントごとに異なります。

    {
      "mcpServers": {
        "taskly": {
          "command": "taskly-mcp",
          "env": {
            "TASKLY_MCP_BASE_URL": "https://mcp.taskly.iy0306.com",
            "TASKLY_MCP_TOKEN": "<issued token>"
          }
        }
      }
    }
  4. 4

    再起動して接続を確認

    MCP クライアントを再起動または再読み込みし、Taskly のツールが表示されることを確認します。最初は「Taskly の課題一覧を表示して」と依頼すると確認しやすいです。

接続に使う設定値

実行コマンド
taskly-mcp
接続先 URL
https://mcp.taskly.iy0306.com
トークンの設定名
TASKLY_MCP_TOKEN

トークンの取り扱い

トークンは第三者に共有しないでください。不要になった場合は MCP 設定画面から無効にできます。

接続できないとき

  • macOS・Linux では command -v taskly-mcp を実行し、インストール先が表示されるか確認します。
  • 設定名が TASKLY_MCP_BASE_URL と TASKLY_MCP_TOKEN になっているか確認します。
  • 接続先 URL の末尾に /mcp や /readyz を追加せず、上記の URL をそのまま設定します。
  • トークンの有効期限が切れている場合は、設定 → MCP で再発行します。