Argentic

Argentic プラグイン

Argentic はエージェントを何時間も実行します。このリポジトリは、お使いのコーディングエージェントを Argentic に接続します。呼び出しの間も記憶を保持するエージェントを起動し、その記憶を読み取り、ツールを与え、API キー、使用状況、予算を管理できます。

このリポジトリに含まれるのは、マニフェスト、スキル、MCP 設定、小さなクライアントアダプターだけです。エンジンは含まれていません。

MCP は https://getargentic.com/mcp の 1 つだけです。Argentic アカウントでサインイン（OAuth）し、組織を選択します。MCP に API キーは不要です。エージェントを起動するには、モデルプロバイダー用のご自身のキーも必要です。このキーは各リクエストの X-Model-Key ヘッダーで送信され、Argentic に保存されることはありません。

デモを実行する（2 分）

https://getargentic.com/platform で取得した Argentic API キーと、モデルキーが必要です。デフォルトのモデルは無料の NVIDIA モデルです。キーは https://build.nvidia.com で取得してください。Node 22 以降が必要です。

export ARGENTIC_API_KEY=aek_...
export MODEL_KEY=nvapi-...
npx @argentic-ai/client demo

fish：

set -x ARGENTIC_API_KEY aek_...
set -x MODEL_KEY nvapi-...
npx @argentic-ai/client demo

小さなサポートエージェントが、数秒おきに 1 つずつアクションを実行し、注文の返金、顧客へのメール送信、チケットのクローズを行います。各ステップでエンジンがプロンプトを再構築します。再起動時の動作を確認するには、実行中に Ctrl-C を押してから、同じフォルダーで同じコマンドを再度実行してください。再実行時には、完了済みのアクションを飛ばして残りを実行します。途中で中断したアクションは再実行されますが、各アクションに安定したキーが付いているため安全です。最後に、デモは送信ボックスに記録された内容（アクションごとに 1 行）を数え、すべての起動をジャーナルと照合し、ダッシュボード上で実行状況を確認できる場所を示します。中断した実行を開き、「Proof of what ran」の下にある「Check」を押してください。

--fresh は新しい実行を開始します。キーボード操作に間に合うか試したくない場合は、--kill-after 1 を指定すると自動的に強制終了します。ソースは adapters/typescript/cli.ts です。

Claude Code

claude plugin marketplace add Argentic-AI/argentic-plugins
claude plugin install argentic@argentic

Claude Code がモデルキー（任意。エージェントの起動にのみ必要）を求め、安全に保存します。その後、/mcp を実行して argentic にサインインしてください。

MCP のみを使い、プラグインは使わない場合：

claude mcp add --transport http --header "X-Model-Key: $MODEL_KEY" argentic https://getargentic.com/mcp

その後、/mcp を実行してサインインしてください。

claude.ai と Claude Projects

Customize、Connectors、Add custom connector の順に選択し、URL に https://getargentic.com/mcp を指定します。Request headers に x-api-key を追加し、モデルキーを設定します（エージェントの起動にのみ必要）。Claude が送信するヘッダー名は Anthropic が承認したものに限られており、X-Model-Key はその対象ではないため、x-api-key を使ってください。Argentic はこれをモデルキーとして読み取ります。Request headers はベータ版の機能で、まだすべてのアカウントで利用できるわけではありません。表示されない場合でも、コネクターでサインインして読み取りはできますが、エージェントの起動には Claude Code または Codex を使ってください。サインインして組織を選択します。Argentic の設定からいつでも接続を解除できます。

スキルを追加するには、Customize、Plugins の順に選択し、Personal plugins の横にある + を押して、Add marketplace、From a repository を選び、Argentic-AI/argentic-plugins を指定します。

Cursor

掲載が開始されたら、Cursor マーケットプレイスで Argentic を検索してください。それまでは、~/.cursor/mcp.json に MCP を手動で追加します。

{"mcpServers": {"argentic": {"url": "https://getargentic.com/mcp"}}}

サーバーを有効にすると、Cursor にサインイン画面が表示されます。

Codex

codex plugin marketplace add Argentic-AI/argentic-plugins

これでスキルが追加されます。~/.codex/config.toml に MCP を追加してください。

[mcp_servers.argentic]
url = "https://getargentic.com/mcp"
env_http_headers = { "X-Model-Key" = "MODEL_KEY" }

Codex の起動時に MODEL_KEY をエクスポートし、codex mcp login argentic でサインインしてください。

さらに：あらゆるエージェントをクラッシュテストする（5 分）

crash-test/ は、ツール呼び出しのたびにエージェントを強制終了して再起動し、どのアクションが 2 回実行されたかを報告する小さなオープンツールです。Argentic の有無を問わず、あらゆるフレームワーク上に構築されたエージェントで動作し、キーも不要です。クイックスタートから始めてください。

MCP を使わない場合

HTTP API は単独でも引き続き利用できます。POST /v1/agents/{agent}/wake およびその他のルートには、Authorization: Bearer として API キー（aek_...。create_api_key ツールまたはダッシュボードで作成）を渡し、起動時には X-Model-Key も渡してください。ドキュメントを参照してください。

お使いのフレームワークをそのまま活用

Vercel AI SDK、Mastra、LangChain / LangGraph、Pydantic AI、OpenAI Agents SDK 向けにすでにツールを作成していますか？ループを Argentic に任せて、ツールはそのまま使えます。adapters/ には各フレームワーク向けの小さなアダプターが用意されています（TypeScript：npm i @argentic-ai/client、Python：PyPI での公開までは argentic-ai を、このリポジトリから pip install してください。詳しくは adapters/python をご覧ください）。また、examples/ には各フレームワーク用の実行可能な返金エージェントと、フレームワークを使わない例が用意されています。実行の途中で停止しても、完了済みのアクションを繰り返さずに再開できます。どちらのクライアントにも、何も書かずに試せる同じデモが付属しています。npx @argentic-ai/client demo または python -m argentic_ai demo を実行してください。

エージェントに実行してもらう

Set up Argentic for me. Read https://getargentic.com/docs/agents and follow it for the tool I'm using right now. Don't ask me to paste keys into this chat: tell me where each key goes and let me put it there. When it's connected, call get_account and tell me what it returned.

プラグインの内容

• argentic スキル：無駄な出費を避け、存在しない機能を誤って案内することなく API を使う方法です。
• argentic-setup スキル：接続して、数セント以内で最初の呼び出しを行います。
• argentic-quickstart スキル：.env にキーを設定して Argentic を自分のプロジェクトに追加し、小規模なテスト呼び出しを実行します。
• argentic-status スキル：エージェントと、中断された実行を一覧表示します。読み取り専用です。
• argentic-fix スキル：実行が停止した原因を特定し、再開するか、承認を求めます。
• Argentic アカウントでサインインした argentic MCP サーバー。
  • アカウントツール：get_account、list_api_keys、create_api_key、revoke_api_key、get_usage、set_budget。
  • エージェントツール：argentic_wake、argentic_fire_due、argentic_resume、argentic_wakes、argentic_wake_get、argentic_replay、argentic_due、argentic_agents、argentic_approvals、argentic_answer_approval。
  • argentic_answer_approval の利用にはオーナーまたは管理者権限が必要です。その他のツールは、役割に応じて利用できます。

MIT ライセンス。