Audryo

Audryo エージェントツールキット

AI エージェントが、Audryo でオーディエンス、ジャーニー、キャンペーン、メール、トランザクション送信などのライフサイクルメールを、アプリと同じ API を通じて実行できるようにします。エージェントが設定を行いますが、人が承認するまでは顧客に何も届きません。

このリポジトリには、audryo CLI、MCP サーバー、Claude Code、Codex、Cursor、その他すべての MCP クライアント向けのエージェントスキルが含まれています。

You:   Set up an onboarding journey for signups who haven't created a
       project after 3 days.

Agent: Reads your data schema, builds the audience, drafts a three-email
       journey, dry-runs it and fast-forwards it in the sandbox. Then it
       hands back what to review. Nothing has been sent.

安全性モデル

• デフォルトでは下書きです。 エージェントが作成するジャーニー、メール、キャンペーンは、レビュー専用の提案です。
• 送信には deliver が必要です。 このスコープがないキーでは、誤操作であってもジャーニーを有効化したり、何かを送信したりできません。このスコープがある場合も、Audryo はドライランの成功とメールの確認を必須とします。
• まずはサンドボックスから。 新しいプロジェクトでは、すべてのメールがサンドボックスの受信トレイに保存されるため、エージェントは実際のジャーニーを最初から最後までテストできます。本番稼働への移行は、アプリ上で人が判断します。
• 再試行しても安全です。 送信と提案には Idempotency-Key を指定するため、呼び出しを再試行しても二重送信されません。
• 同意を推測しません。 連絡先を取り込んでも、マーケティングへの同意は付与されません。

クイックスタート

1. サインアップ（パブリックベータ期間中は無料）して、プロジェクトを作成します。プロジェクトはサンドボックスで開始します。
2. Settings → Developer で、動作に必要な最小限のスコープを持つ API キーを作成します（設定を参照）。
3. エージェントを接続します。

Claude Code（プラグイン：MCP サーバー＋スキル）

export AUDRYO_API_KEY="sf_live_..."
claude plugin marketplace add Audryo/agent-toolkit
claude plugin install audryo@audryo

すべてのエージェント：スキルのみ

npx skills add Audryo/agent-toolkit

すべての MCP クライアント

{
  "mcpServers": {
    "audryo": {
      "command": "npx",
      "args": ["-y", "audryo", "mcp"],
      "env": {
        "AUDRYO_API_KEY": "sf_live_...",
        "AUDRYO_PROJECT_ID": "<project-uuid>"
      }
    }
  }
}

Codex：codex mcp add audryo --env AUDRYO_API_KEY=sf_live_... -- npx -y audryo mcp

設定

変数	必須	デフォルト
AUDRYO_API_KEY	はい	—
AUDRYO_PROJECT_ID	プロジェクト用ツールを使用する場合	npx audryo bootstrap で一覧表示
AUDRYO_API_BASE	いいえ	https://api.audryo.com/v1

エージェントには、動作に必要な最小限のキーを渡してください。

タスク	スコープ
確認	read
データの同期、ジャーニー、メール、キャンペーンの下書き作成	read、write
ジャーニーの有効化、キャンペーンとトランザクションメールの送信	read、write、deliver

MCP ツール

分野	ツール	スコープ
概要	get_manifest、get_bootstrap、get_setup_context、get_brief、get_plan_usage	read
製品とデータ	get_product_context、get_data_context、list_contacts、ingest_contacts、ingest_events	read / write
オーディエンス	list_audiences、get_audience、preview_audience、create_audience、update_audience、delete_audience、suggest_audiences	read / write
ジャーニー	list_journeys、inspect_journey、create_journey_proposal、revise_journey、propose_from_finding、run_dry_run	read / write
メール	create_email、create_journey_email	write
キャンペーン	list_campaigns、draft_campaign	read / write
サンドボックス	get_delivery_mode、list_sandbox_messages、get_sandbox_message、fast_forward_journey	read / write
インサイト	get_delivery_health、get_performance、get_observation、run_observation、get_copilot_plan	read
本番稼働	activate_journey、pause_journey、send_campaign、send_transactional	deliver

すべてのツールは CLI コマンドとしても使用できます。

CLI

npx audryo bootstrap
npx audryo contacts ingest contacts.json
npx audryo events ingest events.json
npx audryo journeys list
npx audryo journeys inspect <workflowId>
npx audryo audiences create --name "All contacts" --definition '{"operator":"and","conditions":[]}'
npx audryo campaigns draft --name "July update" --audience-id <id> --subject "What's new"
npx audryo delivery health

スキル

スキル	エージェントに教える内容
audryo-api	接続、スコープの選択、curl ではなく MCP または CLI の使用、レビュー段階での停止
audryo-email	有効なメール文書の作成、ロケールへの対応、レビュー用の下書き保存
audryo-sending	通信クラスの選択、同意の尊重、配信到達性の保護

詳細ガイド：https://app.audryo.com/docs/agents/quickstart

コントリビューション

Issue とプルリクエストを歓迎します。CONTRIBUTING.md および変更履歴をご覧ください。セキュリティに関する問題は非公開で報告してください： SECURITY.md。

ライセンス：MIT