Skip to content

AI を接続 ​

Yumina には https://yumina.io/mcp に MCP サーバーがあります。ふだん使っている AI ツールに追加して一度ログインすれば、その AI はカードを開き、設定、変数、ビヘイビア、画面のコードを書き、画像を作り、プレイテストできます。変更はすべてキャンバスにリアルタイムで表示されます。公開はできません。そのクリックはあなたのものです。

Studio に組み込まれた AIアシスタントは、設定なしで同じ仕事をします。自分のモデル、自分のサブスクリプション、あるいはターミナルから働き続けるエージェントが欲しいときに、自分の AI をつないでください。

クイックスタート ​

  1. キャンバス右上の ⋮ メニューを開いて AI を接続 をクリックします。カードは先に一度保存しておく必要があります。
  2. ツールを選びます。ダイアログにその手順が出ますが、どれも上のアドレスに行き着きます。
  3. 開いた Yumina のページで 許可する をクリックします。
  4. AI に最初のメッセージを送ります。ダイアログが接続に気づいて、そう伝えます。
text
Yumina でカード「キノコ酒場」を開いて、いま何が入っているか教えて。

クライアントごとの手順 ​

Claude ​

デスクトップ版でもウェブ版でも。設定 → Connectors → Add custom connector を開き、名前を Yumina にしてアドレスを貼り、Continue、次に Add をクリックします。Connect をクリックし、Yumina のページで「許可する」を押します。

ChatGPT と Codex ​

設定 → Plugins → Add → Add MCP server。名前を yumina にして Streamable HTTP を選び、アドレスを貼って Save。Yumina にログインして「許可する」をクリックします。

Cursor ​

ダイアログの Cursor に追加 をクリックするか、次を .cursor/mcp.json に追加してから、Yumina にログインして「許可する」をクリックします。

json
{ "mcpServers": { "yumina": { "url": "https://yumina.io/mcp" } } }

Claude Code ​

bash
claude mcp add --transport http yumina https://yumina.io/mcp

それから Claude Code で /mcp と入力し、yumina を選んで Authenticate、ブラウザで「許可する」をクリックします。

Codex CLI ​

bash
codex mcp add yumina --url https://yumina.io/mcp
codex mcp login yumina

それから ~/.codex/config.toml を開き、[mcp_servers.yumina] の下に 1 行足します。Codex はデフォルトでツールに 60 秒しか与えず、プレイテストや画像生成はそれより長くかかるためです。

toml
tool_timeout_sec = 300

DeepSeek Harness ​

まだログインできないので、ダイアログのそのタブは、開いているカード用のトークンを作り、保存する yumina.yml と、実行するコマンドを渡します。

bash
npx @deepseek-ai/dsh web --patch yumina.yml

トークンはそのカード 1 枚にだけ届き、90 日後に失効します。

そのほかのツール ​

ログインできないなら、ダイアログの ログインできない場合:このカードのトークンを作る を開きます。表示されるアドレスと Authorization ヘッダーをツールに入れてください。トークンの表示は一度だけです。

使い方の例 ​

text
謎かけで話す、人を信じない抜け目のない商人 Vex を追加して。
text
時間とともに減る空腹度の変数を作って。ゼロになったらプレイヤーは死ぬ。
text
体力、マナ、持ち物スロットのあるダークファンタジーの画面を作って。
text
カードの付箋を順に見て、書かれている変更を全部やって。
text
慎重なプレイヤーとして 5 ターンプレイテストして、一度も動かなかった変数を教えて。
text
カードに繋ぎ間違いがないか確認して直して。

使えるツール ​

仕事ツール
カードを探すlist_my_cards、create_card
カードを読むget_world、read_entities、grep_world、list_assets、read_ui_doc、load_skill
無料で確認するvalidate_world、analyze_token_cost、simulate_behaviors
物語を書くwrite_entry、write_variable、write_behavior、write_worldbook、write_audio、write_scene_image、write_note、update_settings、set_card_name、delete_entities
画面を作るwrite_custom_ui、edit_custom_ui、edit_ui_doc、set_ui_knobs
試すplaytest(一度に最大 10 手)と screenshot_ui
画像を作るgenerate_image、set_cover

ほとんどのツールは variant を受け取るので、カードのほかの言語版も扱えます。付箋を読み、それぞれがどこに貼られているかを知っています。サーバーはすべての AI にまず get_world から始めるよう伝え、delete_entities は破壊的とマークされているので、そのヒントを尊重するクライアントは先にあなたに確認します。

費用 ​

読む、書く、確認するのは無料です。プレイテストの手、手を含むスクリーンショット、画像には通常の価格でマッシーがかかります。あなた自身がクリックしたときと同じで、失敗したぶんは返金されます。

セキュリティ ​

  • どの設定ファイルにもパスワードは入りません。 ログインは PKCE 付きの OAuth 2.1 です。AI が持つのは「cards」権限だけの短命なトークンで、それ以外は何もなく、同意ページにはその範囲が正確に並びます。
  • 公開もアカウントへの操作もできません。 公開済みのカードでは、AI の編集はあなたが提出するまで未公開の変更として待ちます。残高、パスワード、設定には触れられません。
  • 変更のたびにチェックポイントを取ります。 ⋮ → 変更履歴に「Before: Claude」など、その AI の名前が出て、そこに戻せます。AI ごとに 15 分に最大 1 つです。
  • 暴走したエージェントは制限が止めます。 1 時間にプレイテスト 30 ターン、画像 20 枚、スクリーンショット 30 枚、1 日に新しいカード 20 枚です。

それでも、次のことはしてください。

  • 公開する前に、AI が書いたものを 読む。AIアシスタントのときと同じです。
  • 使わなくなったものは接続を解除する。 ダイアログの「接続中の AI」か、設定 → アカウント → 連携中のアプリに、それぞれが最後に使われた日時と一緒に並びます。解除すると、その瞬間にアクセスを失います。カードのトークンも同じように一覧され、無効にできます。
  • アカウントはきれいに切り替える。 接続を解除し、ブラウザで Yumina からログアウトして、別のアカウントでログインし、もう一度つなぎます。Codex CLI では codex mcp logout yumina を実行してから codex mcp login yumina を実行します。

コネクターなしで ​

ツールが MCP にまったく対応していないなら、代わりにワールドファイル形式を渡してください。AI がカードの JSON を書き、それをあなたがインポートします。

関連 ​