Codex

• Codexがインストール済みで、ログインしていること。

1. 1

   SPREVAを追加します。

   codex mcp add spreva \
     --url https://dev-app.spreva.ai/api/mcp

2. 2

   ログインします。ブラウザでSPREVAが開くので、ワークスペースを選んで許可をクリックします。

   codex mcp login spreva

3. 3

   追加されていることを確認します。Codexの中では/mcpでも一覧を表示できます。

   codex mcp list

• ヘッダーでAPIキーを送る

  SPREVAのAPIキーをBearerトークンとして送ります。人の操作なしで動く自動化向けです。

  export SPREVA_API_KEY=spreva_sk_...
  codex mcp add spreva \
    --url https://dev-app.spreva.ai/api/mcp \
    --bearer-token-env-var SPREVA_API_KEY

• CLIとAgent Skill

  sprevaコマンドラインとそのAgent Skillをインストールします。ターミナルで作業するエージェント向けです。

  export SPREVA_API_KEY=spreva_sk_...
  npx -y @spreva/cli skill install --target codex

• CLIのstdioブリッジ

  spreva mcpをローカルのMCPサーバーとして実行します。自分のマシン上のサーバーしか起動できないアプリ向けです。

  export SPREVA_API_KEY=spreva_sk_...
  codex mcp add spreva \
    --env SPREVA_API_KEY=$SPREVA_API_KEY \
    -- npx -y @spreva/cli mcp

新しい会話を始めて、次のように聞いてみてください。

CodexがSPREVAのoverviewツールを呼び出し、ワークスペースのタイムゾーン、次に公開されるもの、対応が必要なものを答えます。初回は、Codexがツールの使用許可を求めることがあります。

• Codex CLI、IDE拡張機能、ChatGPTのデスクトップアプリは~/.codex/config.tomlを共有しているため、SPREVAは3つすべてに一度に設定されます。
• クラウドタスクでは、自分のマシンに追加したサーバーは使われません。

ほかの問題については、トラブルシューティングでログインの繰り返し、プラン、上限、タイムゾーンについて説明しています。

• CodexのMCP(新しいタブで開きます)
• Codex用のスキルを作る(新しいタブで開きます)