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日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。
コマンドや設定の例は、「公式の例の写し」と書いたものだけが公式の記載です。「この記事の案」と書いたものは、公式の記載に合わせてこの記事で組んだ例で、動作は確かめていません。取得したページは要約の形なので、実行する前に、公式ページの原文と照らしてください。画面やコマンドの表記は変わることがあります。
先に結論
- スキルは、コマンドの道具(felo-ai)を入れてから、AIツールごとの置き場に入れる2段構え。 キーは
felo config setで渡す方法と、環境変数で渡す方法があります。 - Felo AgentのMCPは「Feloが相手を呼ぶ」側だけ。 公式の手順が確認できたのは、Felo Agentが外のツールにつなぐ側だけです。
- 外し方は、スキルもMCPも、公式に手順の記載が見つかりませんでした。 入れた場所と足した設定が分かっているものだけ、書き出します。
- データの流れの説明は薄い。 末尾の表を見てください。
前提:用語をそろえる
- スキル(Skill):AIのツールに入れる手順書の部品です。各スキルのフォルダに
SKILL.mdというファイルがある、とdocsにあります。 - CLI/ターミナル:黒い画面で命令を打って動かす道具と、その画面です。
- Node.js/npm:コマンドの道具を動かす土台と、その入れ方の命令です。
- 環境変数:ターミナルの中で、プログラムに値を渡す仕組みです。
FELO_API_KEYがそれです。 - MCP(Model Context Protocol):AIと外部のツールをつなぐ共通の決まりです。
- OAuth:パスワードを渡さずに、「このアプリに自分のアカウントを使わせる」と許可する仕組みです。
- Gateway:OpenClawやHermes Agentで、エージェントを動かし続ける常駐の部分を指す語として、docsに出ます(詳しい説明は読んでいません)。
連携1:felo-ai CLIとFelo Skillsを入れる(D)
docs「Felo Skills for AI Agents」と、GitHub(Felo-Inc/felo-skills)のREADMEの記載です。2つの書き方に違いがあるので、併記します。
共通の前提と最初の2コマンド
- docsの要件:Node.js 18以上、npm、対象のエージェントのCLI、FeloのAPIキー。READMEの要件は、今回の取得では読み取れませんでした(APIキーが要る、という記載のみ。Node.jsの版の記載は見つかりませんでした)。
公式の例の写し:
npm install -g felo-ai@latest
felo config set FELO_API_KEY YOUR_API_KEY
- READMEは、キーが
~/.felo/config.jsonに保存される、と書きます。環境変数でも渡せます。 - docsには、コマンドの引数としてキーを渡す書き方になっており、その点(シェルの履歴などへの残り方)の説明は読んだページにありませんでした。環境変数で渡す方法はREADMEにあります。
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のセッション |
- docsは、
npm root -gでパッケージの場所を見つけ、SKILL.mdを含む直下のフォルダをすべて入れる、と書いています。具体的な見つけ方のコマンドは書かれていません。 - docsは、既存の本物のフォルダ、または
felo-aiのパッケージの外を指すリンクは、置き換えずに、衝突として報告するよう書いています。 - Unix系では安全なシンボリックリンク、Windowsではディレクトリジャンクションまたは確認つきのコピー、と書かれています。具体的なコマンドは書かれていません。
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 日本の個人情報保護法の最近の改正点を、出典つきで
渡るデータ、外し方、更新
- 渡るもの:質問の文、取得するURL、YouTubeの動画ID、などの入力が、FeloのAPIに送られる形と考えられます(見立て。READMEとdocsには送り先の明記が見つかりませんでした)。
- 更新:
npm install -g felo-ai@latestをもう一度実行し、新しいスキルを入れ直す、とdocsにあります。 - 外し方:docsにもREADMEにも、アンインストールの手順は書かれていません。入れた場所(上の表)のスキルのフォルダまたはリンク、設定に足した
FELO_API_KEY、~/.felo/config.jsonが、手元に残るものです。消す前に、各エージェントの設定を確かめてください(docsの注意)。
うまくいかないときの確認点(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キーは別に要りません。
手順
- Felo Agentの作業画面で、右上の「Create Agent」を押します。
- エージェントに名前をつけ、具体的な説明を書きます。説明は、エージェントがツールをいつ使うかに影響する、とあります。
- エージェントを作る画面の「Tools」を開きます。
- 「Tools」の中の「MCP Services」を選びます。
- ダイアログに「Popular MCP services」と「Add custom MCP server」が出ます。人気の一覧から選ぶか、「Add custom MCP server」にサーバーのURLを貼ります。
- サーバー(ブログの例は「Notion MCP」)を選び、「Connect」を押します。出てきたOAuthの窓で、自分のアカウントの認可を許可します。そのサーバーのツールが、MCP Servicesの下に出ます。
- エージェントを保存し、チャットを開いて、そのツールが要る仕事を頼みます。
ブログの例の指示文(短い引用)は「Pull the open items from my project tracker and summarize what's blocked.」の趣旨です。
この記事の例(Notionを繋いだ後。動作は確かめていません):
Notionのプロジェクト管理のページから、未完了の項目を取り出して、止まっているものを3行でまとめてください。
期待される結果:ブログによると、うまくつながっていれば、一般的な答えではなく、実際のワークスペースのデータが返る。
渡るデータと権限
- 認可:ブログは、OAuthでNotionのアカウントを認可する、と書いています。認可で何が許可されるか(読み取りだけか、書き込みもか)は、ブログに書かれていません。画面に出る許可の内容を、認可を押す前に読んでください。
- カスタムのサーバーの認証:「そのサーバーが求める認証を済ませる」とだけ書かれ、詳細はありません。
- Felo側の保存期間や、つないだ先のデータが学習に使われるか、といった説明は、ブログにありません。ブログはプライバシーポリシーへ案内しています。
- 使えるプラン(無料か有料か)の条件は、ブログに書かれていません。「Feloのアカウントが必要」とだけあります。
更新履歴にある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の連携を追加 |
- Slackの接続の手順は、今回読んだページに個別には書かれていません。ブログは、Slackを「Popular MCP services」に出てくる名前として挙げています。上の手順4〜6がそのまま使えるかは、公式の資料では確認できていません。
- Agentを共有すると、MCPの設定が引き継がれるのか失われるのかが、更新履歴の2026年8月7日の項目から問題になっていた形で読めます。共有するときは、つないだサービスの権限が、共有先にどう及ぶのかを、画面で確かめる必要があります(見立て)。
外し方
- ブログに、MCPのサービスの外し方(切断、認可の取り消し)は書かれていません。「記載が見つからない」状態です。
- 認可を取り消す場所は、通常、つないだ側のサービス(Notionなら連携の設定)にありますが、Notion側の手順は、この記事では読んでいません。
うまくいかないときの確認点
| 症状 | ブログの記載・確認点 |
|---|---|
| エージェントがツールを使わず答える | 「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で認可。データの流れの説明はブログにない |
- 裏で動くモデルの提供会社への送られ方は、今回読んだページには書かれていません。03の「データはどこへ流れるか」と、APIの規約(03に出典あり)を見てください。
この記事の案: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 |
気をつけること
- この記事は、実際に使って確かめた記録ではありません。公式の記載を並べたものです。
- docsとREADMEで、要件の書き方が違います(Node.jsは、docsが18以上、READMEは版の記載なし。キーの作り方の場所も違う。07を参照)。
- docsは、
felo config setにキーを引数として渡す書き方をしています。コマンドの履歴にキーが残りうるかどうかは、公式の資料に説明が見つかりませんでした。環境変数で渡す方法もREADMEにあります。 - 第三者・個人が公開するFelo用のツール(03)は、この記事の範囲外です。公式のものとは別に扱ってください。
- READMEの
clawhubの入れ方、スクリプトで入れる方法は、仕組みを読んでいません。 - SlackのMCPの個別の手順、MCPの外し方、認可の範囲は、読んだページに書かれていませんでした。
- 取得したページの中に、AIへの指示のような文は見つかりませんでした。
- キー、設定ファイル、OAuthの認可は、漏れたり範囲が広すぎたりすると、料金や情報の流出につながります。この記事の例に書いたキーは、すべて置き換える印(
YOUR_API_KEY)です。 - 規約や個人情報の扱いの解釈は、公式の規約と専門家に確認してください。この記事は法律の助言ではありません。
出典
- Felo Skills for AI Agents(Felo API Platform、Felo Inc.、確認日 2026-10-25)
- Felo-Inc/felo-skills(GitHub、Felo Inc.、確認日 2026-10-25)
- How to Add MCP to Felo Agent(Felo Inc.、2026年9月29日、確認日 2026-10-25)
- What's new with Felo Search?(更新履歴、Felo Inc.、最新2026年10月16日、確認日 2026-10-25)
- Felo API Platform Docs(Felo Inc.、確認日 2026-10-25)
- Claude Code and Codex Configuration(Felo API Platform、Felo Inc.、確認日 2026-10-25)