Fizzy MCP

🚀 fizzy-mcp

Fizzy タスク管理用のMCPサーバーです。ボード、カード、コメント、チェックリストを管理するための7つのツールを提供します。

🚀 クイックスタート

事前準備

Fizzyのアクセストークンを取得します。

1. Fizzyにログインします。
2. 設定 > APIアクセスに移動します。
3. 新しいトークンを生成します。

📦 インストール

Claude Desktop

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

• macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "Fizzy": {
      "command": "npx",
      "args": ["-y", "@silky/fizzy-mcp"],
      "env": {
        "FIZZY_TOKEN": "your-token-here"
      }
    }
  }
}

Windowsのみ: envブロックに"APPDATA": "C:\\Users\\YourUsername\\AppData\\Roaming"を追加します。

Claude Desktopを完全に再起動し、「List my Fizzy boards.」で確認します。

Claude Code

CLIを使用します。

claude mcp add --transport stdio Fizzy --env FIZZY_TOKEN=your-token-here -- npx -y @silky/fizzy-mcp

または、~/.claude.jsonに以下を追加します。

{
  "mcpServers": {
    "Fizzy": {
      "command": "npx",
      "args": ["-y", "@silky/fizzy-mcp"],
      "env": {
        "FIZZY_TOKEN": "your-token-here"
      }
    }
  }
}

Claude Codeを再起動し、「List my Fizzy boards.」で確認します。

Cursor

~/.cursor/mcp.json（グローバル）または.cursor/mcp.json（プロジェクト）に以下を追加します。

{
  "mcpServers": {
    "Fizzy": {
      "command": "npx",
      "args": ["-y", "@silky/fizzy-mcp"],
      "env": {
        "FIZZY_TOKEN": "your-token-here"
      }
    }
  }
}

Cursorを完全に再起動し、エージェントモード（Ctrl+I）で確認します。

VS Code

ワークスペースの.vscode/mcp.jsonに以下を追加します。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "fizzy-token",
      "description": "Fizzy API Token",
      "password": true
    }
  ],
  "servers": {
    "Fizzy": {
      "command": "npx",
      "args": ["-y", "@silky/fizzy-mcp"],
      "env": {
        "FIZZY_TOKEN": "${input:fizzy-token}"
      }
    }
  }
}

または、コマンドパレットから「MCP: Open User Configuration」を選択し、ユーザー設定を使用します。

Windsurf

~/.codeium/windsurf/mcp_config.jsonに以下を追加します。

{
  "mcpServers": {
    "Fizzy": {
      "command": "npx",
      "args": ["-y", "@silky/fizzy-mcp"],
      "env": {
        "FIZZY_TOKEN": "${env:FIZZY_TOKEN}"
      }
    }
  }
}

シェル環境にFIZZY_TOKENを設定するか、値をハードコードします。Windsurfを再起動します。

Cline

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

• macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Windows: %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

{
  "mcpServers": {
    "Fizzy": {
      "command": "npx",
      "args": ["-y", "@silky/fizzy-mcp"],
      "env": {
        "FIZZY_TOKEN": "your-token-here"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Continue

.continue/config.yamlに以下を追加します。

mcpServers:
  - name: Fizzy
    command: npx
    args:
      - "-y"
      - "@silky/fizzy-mcp"
    env:
      FIZZY_TOKEN: ${{ secrets.FIZZY_TOKEN }}

ソースからのインストール

pnpmが必要です。

git clone https://github.com/davegomez/fizzy-mcp.git
cd fizzy-mcp
pnpm install
pnpm build

上記の設定でnpx -y @silky/fizzy-mcpをnode /absolute/path/to/fizzy-mcp/dist/index.jsに置き換えます。

📚 詳細ドキュメント

設定リファレンス

アカウント解決

ツールは以下の順序でaccount_slugを解決します。

1. ツール呼び出し時に明示的に指定されたaccount_slugパラメータ
2. セッションのデフォルト（fizzy_accountツールでaction: "set"を使用して設定）
3. FIZZY_ACCOUNT環境変数
4. 自動検出（ユーザーが1つのアカウントのみを持っている場合）

ツールリファレンス

fizzy_account

後続のツール呼び出し用のアカウントを取得、設定、または一覧表示します。

戻り値:

• get: { "action": "get", "account_slug": "897362094" | null }
• set: { "action": "set", "account_slug": "897362094" }
• list: { "action": "list", "accounts": [{ "slug": "...", "name": "...", "id": "..." }] }

fizzy_boards

アカウント内のボードを列挙し、列の概要を表示します。

戻り値: { "items": Board[], "pagination": { "returned": number, "has_more": boolean, "next_cursor"?: string } }

fizzy_search

フィルターを使用してカードを検索します。

*日付範囲の値: today, yesterday, thisweek, thismonth, last7, last14, last30。

戻り値: { "items": Card[], "pagination": {...} }

fizzy_get_card

番号またはIDでカードの詳細を取得します。

*card_numberまたはcard_idを指定します。UIから人間が読める#がある場合はcard_numberを優先します。

戻り値: id, number, title, description (markdown), status, board_id, column_id, tags, assignees, steps_count, completed_steps_count, comments_count, url, タイムスタンプを含むカードオブジェクト。

fizzy_task

カードを作成または更新します。 モード: card_numberを省略すると作成、含めると更新します。

戻り値: { "mode": "create" | "update", "card": {...}, "operations": {...}, "failures": [...] }

fizzy_comment

カードにコメントを作成、一覧表示、更新、または削除します。

戻り値: id, body (markdown), creator, タイムスタンプ, urlを含むコメントオブジェクト。一覧表示は{ comments, pagination }を返します。削除は{ comment_id, deleted }を返します。

fizzy_step

カードのステップを作成、完了、更新、未完了、または削除します。

モード検出:

• stepがない → 作成 ( contentが必要)
• stepのみあり、他のパラメータがない → 完了
• step + content → 更新
• step + completed: false → 未完了
• step + delete: true → 削除

戻り値: { "id": "...", "content": "...", "completed": true }

ページネーションリファレンス

一覧操作は以下の形式で返します。

{
  "items": [...],
  "pagination": {
    "returned": 25,
    "has_more": true,
    "next_cursor": "opaque-cursor-string"
  }
}

エラーリファレンス

📄 ライセンス

AGPL-3.0-or-later