MCPの接続とトラブルシューティング

リモートMCPでは、https://pixso.net/mcpとOAuthを設定し、対象レイヤーのリンクを指定します。ローカルMCPではPixsoデスクトップ版を起動し、対象ファイルをアクティブにします。使用中の接続方式に合った項目を確認してください。

Pixso MCPは何にアクセスできますか？

MCPツールには、デザインのノード、スタイル、変数、コンポーネントの読み取り、スクリーンショットの取得、デザインからのコード生成やデザイン編集を支援する操作があります。読み取りと書き込みでは必要な条件が異なります。対応する操作と権限は、ツールとコマンドのリファレンス（英語）で確認できます。

接続できてもデザインを読み取れない

1. 認可したアカウントでPixsoのファイルを開き、アクセスできるか確認します。
2. リモートMCPでは、ノード情報を含むレイヤーやフレームのリンクを指定します。
3. アカウントのシートとファイル権限を確認します。書き込みには編集権限が必要です。
4. ローカルMCPでは対象ファイルのタブをアクティブにし、現在の選択範囲を使うタスクでは対象レイヤーを選びます。

コード生成が失敗する・調整が必要

D2C⁺には、D2C⁺クイックスタート（英語）に記載されたエンタープライズのシートとスペースの条件が適用されます。アクセス条件を満たしたら、対象のページやフレームを明確に選び、使用するフレームワークとコンポーネントライブラリを指定します。複雑なデザインは小さな範囲に分けて処理し、レイアウト、文章、素材、操作状態を元のデザインと比較してください。

エージェントにMCPの入口がない・接続できない

Streamable HTTPに対応するバージョンのエージェントを使います。クライアントの設定形式に従い、認可を完了してください。リモートMCPはOAuthと個人アクセストークンに対応します。トークンを公開リポジトリ、スクリーンショット、共有プロンプトに含めないでください。プライベートデプロイメントでは、その環境専用のサービスURLを使います。

Pixsoデスクトップ版にMCPの入口がない

リモートMCPはエージェント側で設定するため、デスクトップ版の入口は不要です。ローカルMCPでは、Pixsoデスクトップ版を2.2.0以降に更新し、デザインファイルを開いて左上のMCP設定入口を使います。

ローカルMCPを有効にしても呼び出せない

Pixsoから現在のサービスアドレスをコピーしてください。ポートは3667とは限りません。SSEではなくHTTP／Streamable HTTPを使います。ポートの競合を避けるため、ローカルMCPの提供元は一つだけを起動し、対象ファイルを開いてアクティブにしておきます。詳しい手順は、ローカルMCPガイド（英語）を参照してください。