セットアップ

Cursor 連携

Cursor から toishi を操作できるようにする設定方法です。
Windsurf も同様の手順で設定できます。

自動セットアップ（推奨）

Terminal

npx @toishi/cli connect

このコマンドは Cursor と Windsurf を自動検出し、設定します。

自動セットアップがうまくいかない場合は、以下の手動セットアップをお試しください。

手動セットアップ

API キーを取得する

toishi にログイン
右上のアバターをクリック → 「設定」
「API キー」タブを選択
「新しいキーを作成」をクリック
表示されたキーをコピー

重要：API キーは一度しか表示されません。安全な場所に保存してください。

設定ファイルを作成・編集する

Cursor の場合：

.cursor/mcp.json

Windsurf の場合：

.windsurf/mcp.json

以下の内容を記述します：

{
  "mcpServers": {
    "toishi": {
      "url": "https://app.toishi.io/api/tools/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

YOUR_API_KEY をステップ1で取得したキーに置き換えてください。

動作確認

Cursor / Windsurf を再起動し、Composer（AI チャット）で以下のように話しかけてみてください：

「toishi のプロダクト一覧を見せて」

プロダクト一覧が表示されれば、設定完了です。

プロジェクト単位 vs グローバル設定

プロジェクト単位（推奨）

プロジェクトのルートに .cursor/mcp.json を配置

✓ プロジェクトごとに異なる API キーを使える
✓ チームで設定を共有できる（.gitignore に追加推奨）
✓ プロジェクトを開いたときだけ有効

グローバル設定

~/.cursor/mcp.json に配置

✓ すべてのプロジェクトで自動的に有効
✓ 一度設定すれば OK
△ API キーの使い分けができない

トラブルシューティング

「toishi への接続に失敗しました」と表示される

以下を確認してください：

API キーが正しくコピーされているか
JSON の構文が正しいか（カンマの位置など）
ファイル名が正しいか（.cursor/mcp.json）
ネットワーク接続が正常か

MCP ツールが表示されない

Cursor を完全に再起動してください。ウィンドウを閉じるだけでなく、プロセスを終了させる必要があります。

Mac: Cmd + Q

Windows: タスクマネージャーから終了

「権限がありません」と表示される

API キーに紐づいたアカウントが、対象のプロダクトにアクセス権を持っていることを確認してください。

toishi の Web 画面でプロダクトにアクセスできるか確認してみてください。

設定完了！

さっそく AI と一緒に要件定義を書いてみましょう

AI 活用ガイドを読む