Clarity

mcp

セットアップガイド

Claude Desktop、Cursor、またはその他の MCP 対応クライアントで Clarity MCP を 2 分以内にセットアップします。

前提条件

  • 少なくとも 1 つのプロジェクトがある Clarity アカウント
  • MCP 対応の AI クライアント（Claude Desktop、Cursor、Windsurf など）

下のセットアップウィザードが、クライアント用のすぐに貼り付けられる設定スニペットを生成します。API キーを貼り付けて設定をコピーするだけです。

1Get your API key

Generate an API key in your Clarity settings. You'll paste it into the config below.

Create API key in Settings
2Configure your client
Config file location:
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Win%APPDATA%\Claude\claude_desktop_config.json
json
{
  "mcpServers": {
    "clarity": {
      "command": "npx",
      "args": [
        "-y",
        "clarity-mcp@latest"
      ],
      "env": {
        "CLARITY_API_KEY": "<your-api-key>",
        "CLARITY_API_URL": "https://www.claritynotes.xyz"
      }
    }
  }
}
  1. 1Open Claude Desktop → Settings → Developer → Edit Config
  2. 2Paste the config below into claude_desktop_config.json
  3. 3Replace <your-api-key> with the key you copied
  4. 4Save the file and restart Claude Desktop
3Verify the connection

Ask your AI assistant:

“List my Clarity projects”

If configured correctly, it will call the list_projects tool and return your workspace.

トラブルシューティング

問題解決策
"CLARITY_API_KEY is required"env ブロックにキーが含まれていることを確認してください
"API 401: Invalid API key"Settings → MCP / API でキーを再生成してください
ツールが表示されない設定の編集後、AI クライアントを再起動してください

AI に 「Clarity のプロジェクトを一覧表示して」 と尋ねることで接続をテストできます。ワークスペースの内容が返されれば、すべて正常に動作しています。

この記事は役に立ちましたか？
前へMCP 連携次へ ツールリファレンス
セットアップガイド — Clarity Docs