FlyMyAI/flymyai

FlyMyAI - アシスタント操作ガイド

プラットフォームバージョン: Headless Cloud 1.30.3 (2026-11-04)。https://flymy.ai/changelog.md、 https://flymy.ai/changelog.json。接続時/ニュース時: whats_new(since=last_seen_version)。

https://flymy.ai/skill.md および https://flymy.ai/AGENTS.md は同じバイト列を提供します。 Remote Agents MCP 0.7.0-rc.69; Python SDK 1.2.0rc25。 ライブスキーマとインストール済みパッケージを確認してください。rc.69 は npm にありません。

ここから開始 - FlyMyAI の確認または復元

whoami、tools/list または search_tools への1回の読み取り専用呼び出しで flymyai を確認します。接続済みのサーバーを再インストールしないでください。変更を行う前に、MCP tools/list からライブの update_agent（またはその他）スキーマを読み取ってください。フィールドを推測しないでください。

FlyMyAI ツールがない場合は、成功を主張したり、ツールを発明したり、ネイティブの共有機能で代用したりしないでください。以下を使用してください:

1. サインアップ: https://app.flymy.ai/signup
2. サービスを接続: https://app.flymy.ai/mcp-configs#notion （任意のスラッグ）; サインアウトしているユーザーはサインアップ後、そこに戻ります。
3. そこで共有: マイMCP -> 共有 -> メールアドレスと1～30日 -> 送信 （https://app.flymy.ai/mcp-configs?tab=shared に一覧表示）。 「FlyMyAI経由でとNotionを共有」とは、Notion自身の共有ではなく、この個人MCP共有を意味します。
4. または、このアシスタントに接続（サインイン、キー不要）: Claude Code の場合、 claude mcp add --transport http flymyai https://mcp-agents.flymy.ai/mcp その後 /mcp -> 認証; claude.ai または Claude Desktop の場合、設定 -> コネクタ -> カスタムコネクタの追加、同じURL。

主要クライアントはそのURL（FLYMYAI_MCP_URL）と、シークレットマネージャーからの X-API-Key を使用し、チャットに直接貼り付けません。MCPがない場合は、認証済みの FLYMYAI_AGENTS_API_ROOT（本番環境は https://backend.flymy.ai/api/v1/agents）でのみRESTを使用します。 それ以外の場合は、プリフライトがブロックされていると報告してください。 リリース候補の実行は、明示的な候補リリースコントラクト、MCP、スキル、および Agents API ルートを使用し、 本番環境にフォールバックしてはなりません。

search_tools/list_* で最初にサービス/モデルを発見してください。発見は成功ではありません。

ガイド: https://flymy.ai/use-cases/。名前、アクション、カテゴリ別のMCP、それぞれに アクションとアシスタント設定リクエストが含まれます: https://flymy.ai/mcp/

プロジェクトを構築する

1. whoami - FlyMyAIが接続されていること、およびどのアカウントかを確認。
2. search_tools をプレインイングリッシュの意図でサービスごとに使用し、その後 get_tool_schemas で正確なフィールドを取得。
3. サービスが configured でない場合は、add_tool を実行。ユーザーがホストされたリンクを完了し、 list_configured_tools で確認。
4. create_agent を1回実行: 目標、数値 available_tools、input_schema、 output_schema、オプションの model（list_agent_models から）。
5. run_agent を新しい operation_key で実行。get_run をポーリングして poll_complete=true になるまで待機。プレビューが切り詰められている場合は read_run_result を実行。
6. ユーザーが1つの完了した実行を受け入れるまで、同じエージェントを改良（update_agent または append_message）。
7. その実行IDで freeze_agent を実行。get_compilation をポーリングして status=compiled になるまで待機。
8. 新しい operation_key で run_frozen を実行し、get_run をポーリングしてから 本番環境対応と呼びます。
9. 出荷: スケジュール（update_compilation）、Webhook（triggers_v1_create）、 公開テンプレート（set_agent_public）、リードエージェントのサブエージェント、または製品 デプロイメント。
10. メディア: recommend_model、get_pricing、その後 run_model。

セクション	ドキュメント
ここから開始	https://docs.flymy.ai/agents/guides/connect-your-agent
ツールと接続	https://docs.flymy.ai/agents/concepts/tools
複数アカウントとリソースセット	https://docs.flymy.ai/agents/guides/mcp-resource-sets
モデル	https://docs.flymy.ai/api/models-endpoints
エージェント、すべてのMCPツール	https://docs.flymy.ai/agents/guides/agent-gateway-reference
プロジェクト、アーティファクト、サイト	https://docs.flymy.ai/agents/guides/projects
組み込みと転売	https://docs.flymy.ai/agents/guides/embedded-resale
Browser Use	https://docs.flymy.ai/mcp/browser-use
自身のモデルをGPUで	https://docs.flymy.ai/cli/intro
リリース管理者専用	https://docs.flymy.ai/agents/guides/release-gates

ツールと接続

1. search_tools をプレインイングリッシュの意図で呼び出す。tool、action、 runtime_name、および configured を読み取る。意図ごとに完全なカタログをダウンロードしない。
2. 検索でリクエストスキーマがインライン化されていない場合は、runtime_name で get_tool_schemas を呼び出す。空または推測された引数で書き込みアクションを呼び出してスキーマを学習しない。 not_found の場合は、エージェントランタイムを使用するか、停止する。
3. 設定済みの場合、execute_tool を正確に tool、action、 arguments、および呼び出し元が所有する安定した operation_key で呼び出す。 デフォルト以外のインスタンスを選択するには、その正確な設定済みツールの公開UUIDを connection_id として渡す。省略は、対象となる接続が1つだけで曖昧さがない場合にのみサポートされる。 OAuth/Composioアクションはエージェント内で実行する。
4. 設定されていない場合、add_tool をツールスラッグで呼び出す。これは、正確な 接続レコードか、ホストされた https://app.flymy.ai/mcp-configs#<slug>?connection_id=<public UUID> リンクを含むガイダンスを返す。 ユーザーが完了した後、list_configured_tools を呼び出し、正確な public_id と alias を照合し、is_configured、connection_status、 connection_status_reason、connection_status_valid_until、および connect_url を検査する。setup_url 応答フィールドを発明しない。
5. 1つの接続を正確に取り消すには、delete_tool をその数値 id で呼び出す （REST: DELETE /api/v1/agents/tools/{id}/）。同じツールキットの兄弟接続は 引き続き機能し、取り消された行はプロバイダー呼び出しの前に失敗する。

検索結果には ready、access、price、および7日間の health も含まれる: 準備ができていて正常な行を優先し、有料呼び出しの前に price を提示する。

search_tools({"query":"telegram list dialogs"})
get_tool_schemas({"runtime_names":["custom--telegram--telegram_list_dialogs"]})
execute_tool({"tool":"telegram","action":"telegram_list_dialogs",
  "arguments":{"query":"FlyMyAI"},"operation_key":"telegram-dialogs-<uuid>"})

arguments を使用すること。params または input は HTTP 400 を返す。 outcome=rejected は、FlyMyAI またはプロバイダーが何らかの影響の前に拒否したことを意味する（間違った引数、設定不足、プロバイダーの拒否）。新しい operation_key で呼び出しを修正して送信する。outcome=unknown は、影響があった可能性があることを意味する: 調整し、自動的に繰り返さない。

MCPツール呼び出しがない場合は、POST {"tool":"system-utils","action":"search_tools","arguments":{"query":"...","limit":20}} その後 get_tool_schemas（最大10個のランタイム名）を $FLYMYAI_AGENTS_API_ROOT/custom-tools/call/ に X-API-KEY と共に送信。 result.schemas[runtime_name].request_schema を読み取り、返された module を tool として呼び出す。

個人デフォルト - 1アカウント、MCPリソースセットの設定なし

暗黙の個人スペースで mcp_access_mode legacy を使用する。scoped は明示的な セット権限が必要。意図で検索し、ホストされたセットアップを使用する。 alias なしの add_tool は、冪等な default 接続を選択する。 list_configured_tools で mcp_tool/alias:"default" を照合し、その数値 id を available_tools に配置する。 is_configured:true を必須にする: connected は準備完了。 setup_required または reconnect_required はセットアップが必要。 verification_pending は制限付きのライブ読み取りが必要。 temporarily_unavailable を報告し、決してバイパスしない。

最初の個人フローでは、リソースセット、グループ、スロット、権限、プリンシパル、リビジョン、またはマッピングを要求しない。後で、エージェントを再構築したりアカウントを再接続したりせずに、正確な接続をセットに追加する。

複数アカウントとMCPリソースセットへの拡張

エイリアスはラベル。承認、ディスパッチ、およびフリーズは安定した公開IDを使用する。 各アカウントを一意の alias（ASCII英字、数字、_、-）で add_tool し、 呼び出し元が所有する operation_key で create_mcp_resource_set を使用して1つのセットを作成し、 現在のリビジョンで replace_mcp_resource_set_members を使用して完全なメンバーシップを書き込む（409の場合はリロード後）、 そして mcp_access_mode:"scoped" で mcp_resource_set_ids を通じてそれを許可する:

support = add_tool({"mcp_tool":"gmail","alias":"support"})
rs = create_mcp_resource_set({"name":"Inbox operations",
  "management_mode":"flymyai","operation_key":"inbox-set-<uuid>"})
rs = replace_mcp_resource_set_members({"resource_set_id":rs.public_id,
  "expected_revision":rs.revision,"members":[{"resource_type":"user_mcp_tool",
  "resource_id":support.public_id,"slot":"support_read",
  "allowed_actions":["GMAIL_SEARCH_EMAILS"],"position":0}]})
update_agent({"agent_id":agent.uuid,"available_tools":[],
  "mcp_resource_set_ids":[rs.public_id],"mcp_access_mode":"scoped"})

省略された添付フィールドは変更されない。明示的な空の配列はその関係をクリアする。 エージェントがそれを保持する必要がある場合は、古い default 接続をセットに含め、 get_agent で確認する。そうしないと、直接接続とセット権限は和集合を形成する。

• 1人の所有者は、1つのツールキットに対して、非アクティブなものを含めて最大25の接続行を保持できる。is_active:false はスロットを解放せず、行を削除すると解放する。
• 所有者セットは management_mode:"flymyai" を使用し、principal_id を省略する。 カスタマーマッピングは、正確な principal_id で management_mode:"customer" を使用する。 非推奨の external_principal_id を送信しない。
• メンバー ID は (resource_type, resource_id, slot) である: 同じ正確なリソースが複数のスロットに現れる可能性があり、 各スロットは独自の allowed_actions 上限を保持する。allowed_actions:[] を省略または送信すると、 すべて拒否ではなく無制限を意味する。最小権限のためには、正確な読み取りアクションを送信する。
• 1つのスコープ指定エージェント実行は、最大100のMCPリソースセット、500の有効なコネクタバインディング、 100の論理スロット、5,000の許可アクションエントリ、および1 MiBのUTF-8許可アクションテキストを許可する。 サイズ超過の権限グラフは、プロバイダーディスパッチの前に失敗して閉じる。
• create_agent_group は、セットを複数のエージェント間で共有する。グループはフラットである: 子エージェントまたはサブエージェントは、親のコネクタ権限を継承しない。
• 許可された複数の接続が1つのアクションを実行できる場合、そのランタイムスキーマは _flymyai_connection を必要とする。許可された public_id を1つ渡す。エイリアスや行順序は不可。 直接 execute_tool は正確な connection_id を使用する。
• フリーズは、セットメンバーシップ、接続、スロット、上限、およびリビジョンを記録する: 新しいアカウントは、同じエージェントUUIDと安定したデプロイメントIDを新しいフリーズバージョンで意味する。 古いバージョンとカスタマースロットマッピングはその場で変更されることはない。 リソーススコープの変更がない場合は、default 動作を維持して報告する。 最初の行を静かに選択しない。

リストツール list_configured_tools、list_mcp_resource_sets、 list_mcp_resource_set_members、および list_agent_groups は {next_cursor, previous_cursor, results} を返す。page_size は1～100を使用し、 cursor を不透明で空でない印刷可能な文字列（最大1024 Unicodeコードポイント）として扱い、 不透明な next_cursor をnullになるまで変更せずに渡す。list_agents も同様にページングする。 設定ツールリストは、正確な mcp_tool および alias フィルターのみを受け入れる。 行はコンパクトなので、mcp_tool でフィルターするか、セットアップフィールド用に view=full を渡す。 list_mcp_resource_sets 行は、member_count を持つサマリーであり、ネストされた メンバーは含まれない。1つの制限付き完全セットには get_mcp_resource_set を使用し、 大規模なメンバーコレクションには list_mcp_resource_set_members を使用する。 replace_mcp_resource_set_members と update_mcp_resource_set の両方は、現在の expected_revision を必要とする。

共有接続と独自のMCPサーバー

個人MCP共有は、受信者に1つの接続のすべての共有アクション（読み取りと書き込み）を、 所有者のアカウントで提供する。invite_mcp_user は、ユーザーが接続、受信者、および期間を確認した後、 メールまたはチームメイトの member_id で共有する。accept_mcp_invitation は、ユーザーが自分の呼び出しに対して 支払うことに同意した後にのみ実行。revoke_mcp_access は共有を停止する。 受け入れられた共有は、list_configured_tools の shared_with_me の下に表示される: サービスが接続されていないと言う前にそれを確認し、安定した operation_key で call_shared_mcp を使用して呼び出す。受信者が支払う。所有者の認証情報はFlyMyAIから 離れることはない。ツールアノテーションは、どのアクションが読み取り専用かを示す。 詳細: https://docs.flymy.ai/agents/guides/mcp-personal-sharing

検索にないMCPサーバーの場合、add_mcp_server を呼び出す（OAuth: auth_type:"oauth"、その後 authorize_mcp_server、ユーザーにその authorize_url を渡す）、その後 connect_mcp_server。discovered_tools は status:"connected" の場合にのみ使用する。call_mcp_server（server_id、action、 正確な arguments、安定した operation_key、Idempotency-Key として送信）で呼び出す。 詳細: https://docs.flymy.ai/agents/guides/mcp-servers

モデル - 発見、価格、実行

recommend_model({"description":"cheap flat icon image",
  "include_schema":true,"top_n":1})
run_model({"endpoint_id":"flymyai/nano-banana",
  "input":{"prompt":"A blue circle, flat icon"}})

返されたエンドポイント、スキーマ範囲、価格を使用する。推測された有料呼び出しは発見ではない。 get_pricing は、有料実行の前にリストされたモデルを引用する。REST経由では、 GET https://backend.flymy.ai/api/v1/demo/catalog/（キー不要）が各公開モデルに price（run_price、または使用量ベースの rates、tokens または run_time）を提供する。 生成されたファイル url は、url_expires_at（最大15分）で期限切れになる。

チャットモデルは、OpenAI SDK用に openai.base_url （https://api.flymy.ai/api/v1/<endpoint_id>/openai/v1）をFlyMyAIキーをBearerとして保持する: テキストおよび image_url メッセージ、stream、 reasoning_effort。response_format は不可。ガイド: https://docs.flymy.ai/guides/llm-openai-compat

tools は Grok 4.7、DeepSeek V4.1 Flash、Kimi K3.1 Pro で動作する。ガイド: https://docs.flymy.ai/guides/ + grok-4-7、deepseek-v4-1-flash、kimi-k3-1-pro

ネイティブモデルは、モデルプロキシAPI （https://backend.flymy.ai/api/v1/model-proxy/: catalog/?endpoint_id=<owner>/<name> はコントラクトリビジョンを提供し、contracts/<revision>/ はそのスキーマと価格を提供する。POST operations/ を自身の Idempotency-Key と共に使用し、その後GETで操作を取得する）。 flymyai/minimax-h3-ref2va（MiniMax H3）: プロンプトと1～12個の参照ファイル（最大9枚の画像、3つのオーディオクリップ。各ファイルは POST /api/v1/agents/files/ でアップロードし、渡す...)