FeiShu MCP リモート呼び出し

HTTPリクエストを使用してFeiShu公式がデプロイしたMCPサービスを呼び出し、ローカルデプロイメントを不要にしてFeiShuのクラウドドキュメント、ナレッジベースなどの機能を利用できます。

エージェント使用ガイド

認可フロー実行時の特別な説明

ユーザーが認可を必要とする場合、以下を実行してください：

1. 認可コマンドを実行：

   node feishu-mcp-client.js auth --app-id <AppID> --app-secret <AppSecret>
   

2. 認可URLを抽出して表示：

   • コマンド出力に「請在浏览器中打开以下 URL 完成授权：」というテキストが含まれます
   • 必ずその直後のURLをユーザーに明確に表示してください
   • ユーザーに対し、そのURLをブラウザで開いて認可を完了する必要があることを伝えてください

3. 認可完了を待機：

   • スクリプトは実行し続け、認可コールバックを待機します
   • ユーザーがブラウザで認可を完了すると、スクリプトは自動的にコールバックを受け取り、トークンを保存します
   • スクリプトが「授権成功！Token 已保存」と出力すれば認可完了です
   • スクリプトを早期に終了しないでください。認可完了のシグナルを待つ必要があります

4. 認可失敗時の処理：

   • 長時間応答がない場合、ユーザーがブラウザで認可を完了したかどうかを確認してください
   • エラーが発生した場合、App ID、App Secret、およびリダイレクトURL設定を確認してください

初期設定

1. FeiShuアプリケーション認証情報の準備

• FeiShu Open Platform にアクセスしてカスタムアプリケーションを作成します
• App ID と App Secret を取得します
• セキュリティ設定でリダイレクトURLを設定します：http://localhost:3000/callback

2. OAuth認可を実行

初回使用時に認可コマンドを実行します：

node feishu-mcp-client.js auth --app-id <あなたのAppID> --app-secret <あなたのAppSecret>

認可フロー：

1. アプリケーション認証情報をローカルに自動保存
2. ローカルコールバックサーバーを起動
3. ブラウザで認可を完了
4. トークンを自動取得して保存

完了後、設定とトークンは ~/.feishu-mcp/ に保存され、その後の使用では認証情報を再度提供する必要はありません。

利用可能なツール

ツール一覧を表示

node feishu-mcp-client.js list-tools --tools "create-doc,fetch-doc,search-doc"

各ツールの詳細説明とパラメータ定義が表示されます。

ツールを呼び出す

node feishu-mcp-client.js call-tool \
  --tool-name "search-doc" \
  --args '{"query":"項目計画"}'

注意事項

1. 初回使用時は auth コマンドを実行して認可する必要があります
2. ツール呼び出しは --tools パラメータで許可するツール一覧を宣言する必要があります
3. ツールパラメータは有効なJSON形式である必要があります
4. トークン期限切れ時は自動更新されます。refresh_tokenが期限切れの場合は再認可が必要です

参考資料

• FeiShu MCP 公式ドキュメント