Soleil Clusters

soleil-clusters-mcp

Soleil Clusters 用の MCP サーバーです。Claude や、その他の Model Context Protocol クライアントからビジュアルボードを読み込んだり、作成したりできます。

このパッケージはおそらく必要ありません

ホスト型サーバーがあり、現在は自動でサインインできます。クライアントから次の URL に接続してください。

{
  "mcpServers": {
    "soleil-clusters": {
      "type": "http",
      "url": "https://clusters.soleilpictures.com/api/v1/mcp"
    }
  }
}

トークンは不要です。最初の呼び出しでは OAuth メタデータへの参照を含む 401 が返されます。クライアントが自身を登録し、ブラウザーを開き、表示される画面で接続を承認します。まだアカウントをお持ちでない場合は、その場で作成できます。サインインに必要なのはメールアドレスの入力だけです。

このパッケージをインストールするのは、ホスト型サーバーでは提供できない唯一のツール、upload_file を使う場合だけです。このツールはローカルディスク上のファイルを読み込みます。アシスタントのメッセージに収まらない大きなメディアも対象です。

npx soleil-clusters-mcp login

{
  "mcpServers": {
    "soleil-clusters": {
      "command": "npx",
      "args": ["-y", "soleil-clusters-mcp"]
    }
  }
}

login はターミナルから同じ OAuth フローを実行します。ブラウザーを開き、ループバックポートでコールバックを受け取り、認証情報を ~/.config/soleil-clusters/credentials.json（モード 600）に保存します。その後は自動で更新されます。npx soleil-clusters-mcp logout を実行すると削除できます。

トークンを使う場合は、引き続き SOLEIL_API_TOKEN を使用できます。こちらが優先されます。Settings → Connections でトークンを発行してください。ホストを変更する場合は SOLEIL_API_BASE で指定します。

できること

31 個のツールを利用できます。検索と取得、ボードやドキュメントの読み込み・書き込み・エクスポート、ボード全体やボード上の画像の確認、アプリがチャット内に描画できる場合に配置どおりのボードをチャット内に表示、ボードやカードの一括作成・変更、段組みまたはメイソンリーレイアウトでのボード配置、リンクでの共有、コメントの読み込み・追加・解決、タグの一覧表示とカードへの付与、URL からのインポート、他システムの識別子の添付、項目の移動・削除、監査ログの読み込みができます。5 つのプロンプトを利用できます。ブリーフからムードボードを作成する、ボードをレビューする、整理する、ボードをもとにトリートメントを作成する、インポートを計画するためのものです。

バージョン 3.0 では、15 個のツールが他のツールに統合されました（get_board は read_board に、update_card は update_cards に統合されるなど）。古い名前で呼び出すと、現在その処理を行うツールが示されます。

完全なリファレンス：https://clusters.soleilpictures.com/docs/mcp

権限

このサーバーは独自の認証情報を保持せず、権限も実装していません。トークンを転送し、API がそのトークンをユーザー自身のセッションに対応付けます。そのため、エージェントがアクセスできるのはアカウントからアクセスできる範囲に限られ、それ以外はデータベースによって拒否されます。

スコープは read、write、delete の 3 つです。削除は意図的に書き込みとは別の権限です。これにより、エージェントに作成を許可しても、破壊的な操作は許可せずに済みます。login が要求するのは read write であり、delete は要求しません。

接続したものはすべて Settings → Connections → Connected apps に表示され、実行した操作と切断ボタンも確認できます。

開発

src/tools.js と src/server.js は、ホスト型サーバーも使用する boards/src/lib/mcpTools.js と boards/src/lib/mcpServer.js から生成されます。これらを編集してから、次を実行してください。

npm run sync

boards/ 内のテストでは、どちらかのコピーが古いと失敗するため、2 つのトランスポートの実装が乖離することはありません。

公開

server.json は、このサーバーの MCP Registry 向けの説明ファイルです。その name と package.json 内の mcpName は一致している必要があります。また、com.soleilpictures 名前空間は、soleilpictures.com のルートドメインにある DNS TXT レコードに基づいています。

npm publish --access public
mcp-publisher login dns --domain soleilpictures.com --private-key <hex>
mcp-publisher publish