3行でいうと

  • 公式のdocsには、APIキーの作成、POST /v2/chat の最初のリクエスト、npx feloapi-cli setup、Claude CodeとCodexの設定の例が書かれています。
  • APIキーを作る画面のURLが、公式のページで3通りに書かれています。
  • 外し方は、feloapi-cliの disconnect、auth logout とキーの失効がdocsにあります。Claude Code・Codexへの直接設定は、動作の確かめ方（起動して、選んだモデルで答えるか）が個別ページにありますが、戻し方は記載が見つかりませんでした。
  • 他のAIからFeloを呼ぶ「Felo MCPサーバー」は、今回読んだページには見つかりませんでした。docsの目次にMCPの専用の節は載っておらず、「Protocols and SDKs」の本文（/docs/guides/protocols）もMCPに触れていませんでした。更新履歴のMCPの項目も、Felo Agentが外のMCPサービスにつなぐ側の記載でした。読んだ範囲の話で、無いと言い切るものではありません。

この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。

コマンドや設定の例は、「公式の例の写し」と書いたものだけが公式の記載です。「この記事の案」と書いたものは、公式の記載に合わせてこの記事で組んだ例で、動作は確かめていません。取得したページは要約の形なので、実行する前に、公式ページの原文と照らしてください。画面やコマンドの表記は変わることがあります。

先に結論

前提：用語をそろえる

連携の地図（その1はA〜C、その2はD・E）

系統 何をするか どこで設定するか 公式の記載
A. API プログラムやcurlからFeloを呼ぶ APIキー＋環境変数 docs「Getting Started」「Authentication」
B. feloapi-cli Codex／Claude Codeに、Feloのモデルやスキルをつなぐ設定を対話で行う npx feloapi-cli setup docs「FeloAPI CLI」
C. Claude Code／Codexの直接設定 AIのツールのモデルの口を、FeloのAPIにする 環境変数、~/.codex/config.toml など docs「Claude Code and Codex Configuration」
D. felo-ai CLIとスキル Claude Codeなどから、検索・スライド生成などを呼ぶ npm install -g felo-ai@latest docs「Felo Skills for AI Agents」、GitHub（08で扱う）
E. Felo AgentのMCP Felo Agentから、Notion、Slackなどを呼ぶ 画面（Create Agent→Tools→MCP Services） ブログ「How to Add MCP to Felo Agent」（08で扱う）

連携1：APIキーを作る（A、B、C、Dの共通の前提）

キーを作る場所：公式の記載が3通り

資料 書かれている場所
docs「Getting Started」（Step 1）と「Authentication」 https://openapi.felo.ai/settings/api-keys
docs「FeloAPI CLI」と「Felo Skills for AI Agents」、docsのトップのリンク、APIサイトのフッター https://openapi.felo.ai/console/api-keys（フッターの表記は「API Keys」。Skillsのdocsは「Felo console under API Keys」の趣旨）
GitHub（Felo-Inc/felo-skills）のREADME 「felo.ai（Settings → API Keys）」の表記

どれが現行かは、読んだページからは決められません。ログインした状態で、どのURLが開くかを手元で確かめてください。

手順（docs「Getting Started」「Authentication」の記載）

  1. 上のAPI Keysの画面を開きます。求められたら、Feloのアカウントでサインインします。
  2. キーの名前を入れ、「Create Key」を押します。
  3. 作られたキーの全体をコピーします。全体が見られるのは、作った直後の1回だけ、と書かれています（FeloAPI CLIのdocsも、一覧では一部を伏せた表示になる、と書く）。
  4. 他人に見られない場所に保管し、環境変数 FELO_API_KEY にします。

macOS／Linux（公式の例の写し）：

export FELO_API_KEY="YOUR_API_KEY"

Windows PowerShell（公式の例の写し）：

$env:FELO_API_KEY="YOUR_API_KEY"

YOUR_API_KEY は置き換える印で、実際のキーを書く場所です。この記事には実際のキーは書きません。

キーの扱い（docs「Authentication」の記載）

払い方

連携2：最初のAPIリクエストを送る（A）

docs「Getting Started」の「Step 4: Verify with a Direct API Call」と、docsのトップの記載です（「Your First Request」という見出しは、再取得したGetting Startedには見つかりませんでした）。

手順1：キーとモデルの一覧を確かめる

curl https://openapi.felo.ai/api/v1/models \
  -H "Authorization: Bearer $FELO_API_KEY"

（docsのトップの公式の例の写し。キーが正しいと、使えるモデルの一覧が返る、という流れの確認です。）

手順2：Chat APIに質問する

curl -X POST https://openapi.felo.ai/v2/chat \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Research the latest AI agent product trends"
  }'

（docs「Getting Started」の公式の例の写し。）

手順3：データAPIを試す

docsのトップに、Tavilyの検索を呼ぶ例があります。

curl https://openapi.felo.ai/v1/beta/tavily/search \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"What is Felo AI?","max_results":3}'

（公式の例の写し。経路に beta を含みます。03で書いたとおり、データAPIは「Data API (Beta)」の扱いです。）

渡るデータ、権限

エラーとレート制限（docs「Authentication」の記載）

コード 意味 直し方
INVALID_API_KEY キーが無効、形が違う、または失効している キーを確かめる、失効していないか見る、新しく作る
MISSING_AUTHORIZATION ヘッダーが送られていない Authorizationヘッダーを入れる
MALFORMED_AUTHORIZATION ヘッダーの形が違う Bearerの形にする
EXPIRED_API_KEY キーの期限切れ 新しいキーを作る
RATE_LIMITED リクエストが多すぎる 間を空ける、または問い合わせる

外し方

連携3：feloapi-cliで、Codex／Claude Codeをつなぐ（B）

docs「FeloAPI CLI」の記載です。

前提（docsの記載）

手順（docsの記載の順）

  1. Felo ConsoleのAPI Keysの画面を開き、サインインします。
  2. キーを作り、作成の結果から、全体のキーをコピーします。一覧には一部を伏せた表示しか出ないので、なくしたら新しく作ります。
  3. 次のコマンドを実行します。
npx feloapi-cli setup
  1. 「Codex」か「Claude Code」を選びます。
  2. 「Models + Skills」「Skills only」「Models only」のどれかを選びます。
  3. 求められたら、キー全体を貼ります（入力は表示されない）。
  4. モデルを設定するなら、自分のアカウントで使えるものを選びます。Codexには、Responsesに対応した文章のモデルが、Claude Codeには、Anthropic Messagesに対応したモデルが必要、と書かれています。
  5. 設定の内容のプレビューを確かめ、確認して保存します。
  6. エージェントを起動します。
npx feloapi-cli run codex
npx feloapi-cli run claude-code

付属のコマンド（コードブロックにあるものは公式の例の写し）

npm install -g feloapi-cli
feloapi setup
feloapi run codex

npx feloapi-cli setup --agent codex --skills-only

npx feloapi-cli models
npx feloapi-cli connect codex --model YOUR_MODEL_ID --dry-run

npx feloapi-cli doctor
npx feloapi-cli --help

キーの更新は npx feloapi-cli auth login、手元のキーの削除は npx feloapi-cli auth logout です。どちらも、ページの文中に書かれた形で、コードブロックの例ではありません。

何が書かれ、何が変わるか（docsの記載）

外し方（docsの記載）

npx feloapi-cli disconnect codex
npx feloapi-cli disconnect claude-code
npx feloapi-cli auth logout

うまくいかないときの確認点

症状 確認点（docsの記載から）
setup が動かない Node.jsが22以上か。CodexまたはClaude Codeが別に入っているか
モデルが選べない 自分のアカウントで使えるモデルか。Codexは Responses、Claude Codeは Anthropic Messages に対応したものか
Codexのモデル設定が効かない Codex CLIが0.134.0以上か
スキルが読み込まれない 新しいエージェントのセッションを始めたか
設定を確かめたい doctor を実行する

連携4：Claude CodeとCodexに、FeloのAPIを直接設定する（C）

docs「Claude Code and Codex Configuration」の記載です。コードに混ざる「Copy」の文字（コピーのボタンの印）は、実行前に取り除く、と取得結果の注意にありました。

まず、キーを環境変数に入れます（公式の例の写し）。

export FELO_API_KEY="YOUR_API_KEY"

Claude Code

シェルの環境変数の例（公式の例の写し）：

export ANTHROPIC_API_KEY="$FELO_API_KEY"
export ANTHROPIC_BASE_URL="https://openapi.felo.ai/api"
export ANTHROPIC_MODEL="claude-sonnet-4-6"

claude

設定ファイルの例（env ブロックの例。docsはファイルの名前を示していません。キーはプロジェクトの設定に入れないように、と書かれています）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openapi.felo.ai/api",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  }
}

Codex

公式の例（写し）：

model_provider = "felo"
model = "gpt-5.6-sol"

[model_providers.felo]
name = "Felo API Platform LLM API"
base_url = "https://openapi.felo.ai/api/v1"
env_key = "FELO_API_KEY"
wire_api = "responses"

渡るデータ、確認、外し方

渡るデータ（その1の連携）

連携 送り先 公式の説明
A. API openapi.felo.ai キー、質問、リクエストの内容。保存期間の説明は、読んだページに見つからなかった
B. feloapi-cli キー：手元の ~/.feloapi/state.json。モデル・スキルの呼び出しは、FeloのAPI 手元に保存すること、暗号化されないことは書かれている
C. Claude Code／Codexの直接設定 AIのツールからのリクエストの宛先がFeloのAPIになる データの流れの説明は、読んだdocsにない

気をつけること

出典