3行でいうと

  • felo-ai CLIは npm install -g felo-ai@latest で入れ、felo config set FELO_API_KEY YOUR_API_KEY でキーを設定します。スキルは、Codex、Claude Code、OpenClaw、Hermes Agentごとの置き場に入れる、とdocsにあります。
  • Felo Agentの中のMCPは、公式ブログに「Create Agent」→「Tools」→「MCP Services」→「Connect」の手順があります。例はNotion。更新履歴にはSlackとSalesforceのMCPも出ます。
  • MCPの外し方、認可の範囲、使えるプランは、ブログに記載が見つかりませんでした。スキルのアンインストールも、docsとREADMEに記載が見つかりませんでした。
  • 他のAIからFeloを呼ぶ「Felo MCPサーバー」は、今回読んだページには見つかりませんでした(docsの目次、Protocolsのページ、更新履歴にも記載なし。読んだ範囲の話で、無いと言い切るものではありません)。

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

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

先に結論

前提:用語をそろえる

連携1:felo-ai CLIとFelo Skillsを入れる(D)

docs「Felo Skills for AI Agents」と、GitHub(Felo-Inc/felo-skills)のREADMEの記載です。2つの書き方に違いがあるので、併記します。

共通の前提と最初の2コマンド

公式の例の写し:

npm install -g felo-ai@latest
felo config set FELO_API_KEY YOUR_API_KEY

READMEの「環境変数」の例:

export FELO_API_KEY="..."
$env:FELO_API_KEY="..."

(上がLinux・macOS、下がWindows PowerShell。READMEの例の写し。)

felo config には、set、get、list、path の副コマンドがある、とREADMEにあります。

エージェント別の入れ方(docsの記載)

エージェント スキルの置き場所 キーの置き場所 最後の手順
Codex ~/.codex/skills/<skill> docsのこのページには記載なし(READMEは、felo config set で入れたキーが ~/.felo/config.json に保存されると書く) 新しいCodexのセッションを始める
Claude Code ~/.claude/skills/<skill> ~/.claude/settings.json の env に FELO_API_KEY を足す(手で編集。コマンドは示されていない) 新しいClaude Codeのセッションを始める
OpenClaw ~/.agents/skills/<skill> ~/.openclaw/openclaw.json の skills.entries.<skill>.env に FELO_API_KEY を足す openclaw skills list と openclaw gateway status。動いているGatewayは再起動する(コマンドは示されていない)
Hermes Agent ~/.hermes/skills/<skill> hermes config set FELO_API_KEY YOUR_API_KEY hermes skills list。Gatewayが動いていれば再起動、そうでなければ新しいCLIのセッション

Claude Codeに手で入れる方法(READMEの記載)

READMEには、リポジトリを取ってきて、フォルダをコピーする方法があります。

git clone https://github.com/Felo-Inc/felo-skills.git
cd felo-skills
cp -r felo-search ~/.claude/skills/

(READMEは、スキルごとに cp -r の行を並べています。ここでは最初の1つだけを写しました。Gemini CLIは ~/.gemini/skills/、Codexは ~/.codex/skills/ に置き換える、とあります。)

スクリプトで入れる方法(READMEの記載)

READMEには、OpenClawとHermes向けに、公開のスクリプトをダウンロードして実行する書き方があります(scripts/openclaw-install.sh と scripts/install-hermes.sh)。コマンドの全文は、GitHubのREADMEの原文で確認してください。インターネットから取ってきたスクリプトをそのまま実行する形なので、実行する前に、スクリプトの中身を自分で読めます(この記事の案)。

「ClawHub」で入れる方法(READMEとdocsの記載)

clawhub install felo-search のような書き方が、READMEにあります。READMEは、これを「Claude Code(ClawHubで)」の見出しで載せ、スキル名(felo-search、felo-slides、felo-landingpage、felo-mindmap、felo-web-fetch、felo-youtube-subtitling、felo-x-search、felo-livedoc、apple-buy-advisor、doc-snapshot-agent、felo-superAgent、felo-twitter-writer)を並べます。同じ名前が重なって書かれている部分があり、felo-superAgent は felo-livedoc に、felo-twitter-writer は両方に依存する、と書かれています。ClawHubが何かは、読んだページには説明がありません。

確かめる(docsの記載)

felo --version
felo config path
felo search "test query"

docsは、確認の際にキーを画面に出さないように、と書いています。

使い方の例(READMEの記載)

CLI:

felo search "Tokyo weather"
felo slides "Felo product intro, 3 slides"
felo mindmap "AI trends in 2024"
felo web-fetch --url "https://example.com"
felo x "AI news"
felo livedoc list
felo superagent "What is the latest news about AI?"

Claude Codeの中では、スキルを /felo-search 調べたいこと のように呼ぶ例があります(/felo-slides、/apple-buy-advisor、/felo-twitter-writer、/felo-superAgent、/doc-snapshot-agent も同様)。READMEは、スキルが自動で反応しないときは、このように手で呼ぶよう書いています。

この記事の例(Claude Codeの中で。動作は確かめていません):

/felo-search 日本の個人情報保護法の最近の改正点を、出典つきで

渡るデータ、外し方、更新

うまくいかないときの確認点(READMEの記載)

症状 READMEの記載
キーが見つからない felo config set FELO_API_KEY <key> を実行するか、環境変数を設定する
時間切れ --timeout 120(初期は60秒)
スライドが遅い --poll-timeout 300(初期は1200秒)
スキルが反応しない /felo-search 調べたいこと のように手で呼ぶ

連携2:Felo Agentの中でMCPのサーバーにつなぐ(E)

公式ブログ「How to Add MCP to Felo Agent」(2026年9月29日)の記載です。Felo側が、外のツールを呼ぶ側になります。ブログによると、Felo側の設定やFeloのAPIキーは別に要りません。

手順

  1. Felo Agentの作業画面で、右上の「Create Agent」を押します。
  2. エージェントに名前をつけ、具体的な説明を書きます。説明は、エージェントがツールをいつ使うかに影響する、とあります。
  3. エージェントを作る画面の「Tools」を開きます。
  4. 「Tools」の中の「MCP Services」を選びます。
  5. ダイアログに「Popular MCP services」と「Add custom MCP server」が出ます。人気の一覧から選ぶか、「Add custom MCP server」にサーバーのURLを貼ります。
  6. サーバー(ブログの例は「Notion MCP」)を選び、「Connect」を押します。出てきたOAuthの窓で、自分のアカウントの認可を許可します。そのサーバーのツールが、MCP Servicesの下に出ます。
  7. エージェントを保存し、チャットを開いて、そのツールが要る仕事を頼みます。

ブログの例の指示文(短い引用)は「Pull the open items from my project tracker and summarize what's blocked.」の趣旨です。

この記事の例(Notionを繋いだ後。動作は確かめていません):

Notionのプロジェクト管理のページから、未完了の項目を取り出して、止まっているものを3行でまとめてください。

期待される結果:ブログによると、うまくつながっていれば、一般的な答えではなく、実際のワークスペースのデータが返る。

渡るデータと権限

更新履歴にあるMCPの変更

日付 内容
2025年5月12日 Felo AgentにNotionのMCPのツールを追加
2025年7月11日 Slides AgentにMCPの接続を追加
2026年6月8日 MCPの認可の失敗を直した
2026年7月28日 MCPのツールが失敗したあとも、Agentのワークフローが止まらない不具合を直した。履歴でMCPのツール名が誤って表示される不具合も直した
2026年8月7日 Agentを共有したあと、MCPの設定が失われる不具合を直した
2026年9月18日 SlackとSalesforceのMCPの連携を追加

外し方

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

症状 ブログの記載・確認点
エージェントがツールを使わず答える 「Tools」の画面を開き直して、MCPのサービスが接続(connected)の表示になっているかを確かめる
ツールが使われない エージェントの説明(description)が具体的かを見る。説明がツールの使い方に影響する、とある
認可の窓が出ない/失敗する ブログに記載なし。更新履歴に、認可の不具合の修正(2026年6月8日)がある

渡るデータの整理

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

この記事の案:AI同士の組み合わせ例

公式の記載を並べ替えた案で、動作は確かめていません。公式がこの組み合わせを勧めている、という意味ではありません。

組み合わせ 流れ 使う連携
Claude Code × Feloの検索 Claude Codeの作業の途中で、/felo-search を呼んで、出典つきの下調べをしてもらう 07の連携1、本記事の連携1
Codex × Feloのモデル Codexのモデルの口をFeloのAPIにして、Codexの会話をFelo経由にする 07の連携1、4
Felo Agent × Notion Notionの項目をFelo Agentに読ませて、まとめを作らせる 本記事の連携2
ターミナル × スライド生成 felo slides "..." でスライドの下書きを作る 本記事の連携1

気をつけること

出典