YAMLコネクタ

YAMLエンジンはコードを書かずに作成するための方法です。宣言的なマニフェストを、型付きサーバーと同じMCPサーフェスにコンパイルします。パラメーター付きツール、レスポンス変換によるPresenter、リソース、プロンプト、接続を扱えます。内部REST APIをすばやくラップするために使い、ドメインにカスタム動作が必要になったら型付きMVAコードへ移行してください。

完全なマニフェスト

version: "1.0"
server:
  name: billing
  description: Invoice operations for an AI agent
  capabilities:
    tools: true
    resources: true
secrets:
  BILLING_TOKEN:
    label: Billing API token
    type: api_key
    required: true
    sensitive: true
connections:
  billing:
    type: rest
    base_url: https://api.example.com
    auth:
      type: bearer
      token: ${SECRETS.BILLING_TOKEN}
tools:
  - name: list_invoices
    description: List invoices for the current account
    rules:
      - Never expose internal_notes to the model
    parameters:
      account_id:
        type: string
        required: true
        description: Account identifier
    execute:
      connection: billing
      method: GET
      path: /accounts/{{account_id}}/invoices
    response:
      extract: [data]
      max_items: 50

パーサーはZodでルートスキーマを検証し、相互参照を確認し、環境から ${SECRETS.KEY} を展開し、パラメーターをJSON Schemaにコンパイルし、接続を解決してローカルMCPサーバーを構築します。

マニフェストの構成

• server: 名前、説明、capabilities、指示
• secrets: api_key、token、password、url などの型付き宣言、requiredとsensitiveのフラグ
• connections: RESTベースURL、認証（none、bearer、basic、custom header）、ヘッダー、タイムアウト、リトライポリシー
• tools: 説明、指示、ルール、タグ、アノテーション、パラメーター、HTTP executeブロック、レスポンス変換
• resources: URIテンプレート、静的または取得したコンテンツ、MIMEタイプ、オプションのキャッシュ
• prompts: フラットなプリミティブ引数と {{argument}} を使うユーザー／アシスタントメッセージテンプレート
• settings: exposition、DLP、FinOps、circuit breaker、ライフサイクルの宣言

CLI

mcpfusion yaml validate mcpfusion.yaml
mcpfusion yaml dev mcpfusion.yaml --transport http --port 3001

CLIは現在のディレクトリにある mcpfusion.yaml または mcpfusion.yml を自動検出します。validate はスキーマと相互参照の確認後に停止します。dev はデフォルトでstdioを実行し、選択したポートではStreamable HTTPを実行します。

現在のYAMLパッケージにはOSS CLIのvalidateとdevコマンドがあります。コンパイル済みコネクタは通常の Deploy フローでデプロイしてください。インストールしたCLIが提供していない限り、別のYAMLデプロイコマンドがあるとは考えないでください。

OSSが強制すること

オープンエンジンは、スキーマの形、必須フィールド、パラメーター型、相互参照、シークレット展開、REST実行を強制します。DLP、FinOps、circuit breaker、ライフサイクルのsettingsキーはマニフェストの一部として解析されます。これらのプラットフォーム制御の適用はVinkius Cloudが担当します。この分離により、同じYAMLをローカルで実行しながら、ホストされたコネクタにはプラットフォームの境界を適用できます。

YAMLでは足りなくなる場合

動的なPresenter、ロール依存スキーマ、カスタムミドルウェア、トランザクション、FSM状態ゲート、ジェネレーターハンドラー、ドメイン固有のエラー復旧が必要なら、型付きMVAコードを選んでください。移行はプロトコルの書き換えではありません。同じツール、リソース、プロンプトを initMCPFusion() で再構築し、同じコマンドでデプロイできます。

次のステップ

• The MVA pattern: YAMLがコンパイルする型付きの道筋
• Credentials: 購入者が管理するシークレットを宣言する
• CLI: 共通の開発コマンド