AI を接続
Yumina には https://yumina.io/mcp に MCP サーバーがあります。ふだん使っている AI ツールに追加して一度ログインすれば、その AI はカードを開き、設定、変数、ビヘイビア、画面のコードを書き、画像を作り、プレイテストできます。変更はすべてキャンバスにリアルタイムで表示されます。公開はできません。そのクリックはあなたのものです。
Studio に組み込まれた AIアシスタントは、設定なしで同じ仕事をします。自分のモデル、自分のサブスクリプション、あるいはターミナルから働き続けるエージェントが欲しいときに、自分の AI をつないでください。
クイックスタート
- キャンバス右上の ⋮ メニューを開いて AI を接続 をクリックします。カードは先に一度保存しておく必要があります。
- ツールを選びます。ダイアログにその手順が出ますが、どれも上のアドレスに行き着きます。
- 開いた Yumina のページで 許可する をクリックします。
- AI に最初のメッセージを送ります。ダイアログが接続に気づいて、そう伝えます。
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 にログインして「許可する」をクリックします。
{ "mcpServers": { "yumina": { "url": "https://yumina.io/mcp" } } }Claude Code
claude mcp add --transport http yumina https://yumina.io/mcpそれから Claude Code で /mcp と入力し、yumina を選んで Authenticate、ブラウザで「許可する」をクリックします。
Codex CLI
codex mcp add yumina --url https://yumina.io/mcp
codex mcp login yuminaそれから ~/.codex/config.toml を開き、[mcp_servers.yumina] の下に 1 行足します。Codex はデフォルトでツールに 60 秒しか与えず、プレイテストや画像生成はそれより長くかかるためです。
tool_timeout_sec = 300DeepSeek Harness
まだログインできないので、ダイアログのそのタブは、開いているカード用のトークンを作り、保存する yumina.yml と、実行するコマンドを渡します。
npx @deepseek-ai/dsh web --patch yumina.ymlトークンはそのカード 1 枚にだけ届き、90 日後に失効します。
そのほかのツール
ログインできないなら、ダイアログの ログインできない場合:このカードのトークンを作る を開きます。表示されるアドレスと Authorization ヘッダーをツールに入れてください。トークンの表示は一度だけです。
使い方の例
謎かけで話す、人を信じない抜け目のない商人 Vex を追加して。時間とともに減る空腹度の変数を作って。ゼロになったらプレイヤーは死ぬ。体力、マナ、持ち物スロットのあるダークファンタジーの画面を作って。カードの付箋を順に見て、書かれている変更を全部やって。慎重なプレイヤーとして 5 ターンプレイテストして、一度も動かなかった変数を教えて。カードに繋ぎ間違いがないか確認して直して。使えるツール
| 仕事 | ツール |
|---|---|
| カードを探す | 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 を書き、それをあなたがインポートします。
