Persona

@laplace.live/persona-mcpはPersona公式のMCPサーバーで、プラグインAPIをAIアシスタントに渡します。シーンの切り替え、モデルの読み込みと配置、表情の切り替え、モーションの再生、オートメーションの実行、そして編集の結果を確かめるためのステージのスクリーンショットができます

WebコンソールやStream Deckプラグインと同じAPIを使い、それ以上のものは何も開きません。デスクトップアプリのコードには一切触れないので、これができることはすべてプラグインAPIでもできます

前提条件

セットアップ

次のブロックをMCPクライアントの設定に追加します。Claude Desktopのclaude_desktop_config.jsonもCursorのmcp.jsonもこの形式です：

{
  "mcpServers": {
    "persona": {
      "command": "npx",
      "args": ["-y", "@laplace.live/persona-mcp"],
      "env": { "PERSONA_TOKEN": "psk_…" }
    }
  }
}

Claude Codeならコマンド1つで済みます：

claude mcp add persona -e PERSONA_TOKEN=psk_… -- npx -y @laplace.live/persona-mcp

環境変数は2つです：

起動時に失敗することはありません。MCPクライアントはPersonaが開く前にサーバーを立ち上げることが多いため、最初のツール呼び出しまで接続しません。トークン未設定、アプリ未起動、キーの失効はいずれもクラッシュではなく、何を直せばよいかをアシスタントに伝えるテキストとして返ります

接続すると、Personaの接続中のクライアントにPersona MCPという行が現れます。括弧内はクライアントが自己申告した名前で、開発元はLAPLACEです

ツール

ツールはプロトコルのメソッドごとに1つ包むのではなく、タスク単位で20個ほどにまとめてあります——一覧が長いほどモデルは選び損ね、毎ターンのコンテキストも食うからです。読み取り専用のツールにはすべてreadOnlyHintが付き、delete_sceneとremove_itemにはdestructiveHintが付くので、破壊的な呼び出しを確認するクライアントでは確認が入ります

2Dアイテムの配置はステージ中心を原点としたピクセル（+yが下）で、回転はラジアンです。3Dアイテムはメートルとラジアンです。これらはツール自身の説明に書かれているので、アシスタントが推測する必要はありません

ステージを見る

capture_stageの背後にあるのが新しいstage.captureメソッドです。ステージウィンドウの表示そのままを、透過付きのPNGとして返します。最長辺はデフォルトで1024px、最大2048pxで、拡大は行いません。アプリがstage-captureケイパビリティを報告している必要があり——0.55.0以降です——それより古い場合はツールが更新を促します

1回のキャプチャごとにステージは1フレーム止まるので、結果を確かめたい場面でだけ使い、定期的に回すものではありません

補完としてのcall_api

他のツールが扱わないもの——カメラ、ライティング、環境、レイヤーエフェクト、オブジェクトとウェブページ、プロップのスポーン、トラッキングソース、リップシンク、音声、設定——はcall_apiから呼びます。メソッド名とパラメータのオブジェクトを渡すだけです。知らないメソッド名もそのまま転送するので、Personaを更新すれば、このパッケージの追従を待たずに新しいメソッドが使えます

パラメータが不正なときは、どのフィールドかを示すエラーが返ります。プロトコルレベルのエラーには、正しい値をどのツールから取ればよいかというヒントも付きます