Feishu Business Operations

feishu-scenarios-mcp

Feishu/Lark 向けの AI ネイティブな業務運用 MCP サーバーです。多次元テーブル（Bitable）と承認を対象に、検索、クエリ、書き込み、作成、AI によるスキーマ設計、承認の追跡、アラート、統計の 8 つのシナリオベースのツールを提供します。

インストール

npm install -g feishu-scenarios-mcp

または、直接実行します：

npx feishu-scenarios-mcp

設定

Feishu アプリの認証情報を記載した .env ファイルを作成します：

FEISHU_APP_ID=cli_xxxxxxxxxxxx
FEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxx
FEISHU_BITABLE_APP_TOKEN=xxxxxxxxxxxx
FEISHU_ENV=feishu

変数	必須	説明
FEISHU_APP_ID	はい	Developer Console で確認できる Feishu アプリ ID
FEISHU_APP_SECRET	はい	Feishu アプリのシークレット
FEISHU_BITABLE_APP_TOKEN	Bitable の場合	Bitable アプリのトークン
FEISHU_ENV	いいえ	feishu（デフォルト）または lark
FEISHU_USER_ID	承認の場合	Feishu のユーザー open_id
DEEPSEEK_API_KEY	スキーマ AI の場合	AI によるテーブル設計用の DeepSeek API キー

Claude Desktop の設定

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "feishu-scenarios": {
      "command": "npx",
      "args": ["-y", "feishu-scenarios-mcp"],
      "env": {
        "FEISHU_APP_ID": "cli_xxxxxxxxxxxx",
        "FEISHU_APP_SECRET": "xxxxxxxxxxxxxxxx",
        "FEISHU_BITABLE_APP_TOKEN": "xxxxxxxxxxxx",
        "FEISHU_ENV": "feishu"
      }
    }
  }
}

ツール

Bitable（多次元テーブル）

ツール	説明
bitable_search	キーワードでテーブルを検索します。テーブル ID、名前、フィールドのプレビュー、レコード数を返します。
bitable_query	任意のフィルターを指定してレコードをクエリします。
bitable_upsert	レコードを一括で書き込みます。フィールド名の自動照合と型変換に対応します。
bitable_create	フィールド定義を指定して新しいテーブルを作成します。
bitable_schema_ai	業務内容の説明から、AI がテーブルスキーマを設計します。DEEPSEEK_API_KEY が必要です。

承認

ツール	説明
approval_list	ステータス、種類、申請者、期間を指定して承認インスタンスをクエリします。
approval_alerts	ボトルネックや期限超過の承認を検出します。デフォルトのしきい値は 48 時間です。
approval_stats	ステータス別、種類別、月別、申請者上位の承認統計を表示します。

使用例

テーブルを検索：

「『审批』を含むテーブルを検索して」

レコードをクエリ：

「滞留追跡テーブルで、ステータスが pending のレコードを調べて」

レコードを書き込み：

「追跡テーブルに、担当者は张三、ステータスは対応待ちでレコードを 1 件追加して」

AI でテーブルを設計：

「承認の滞留を追跡するテーブルを設計して」

承認アラート：

「承認が最も遅いのは誰？」

承認統計：

「今月の承認通過率」

Feishu Bot（モバイル）

このパッケージには、モバイルからアクセスできる WebSocket ベースの Feishu Bot も含まれています：

npx feishu-scenarios-mcp-bot

セットアップガイド：docs/bot-setup.md

必要な Feishu 権限

• approval:instance — 承認インスタンスの読み取り
• bitable:app — Bitable へのアクセス
• im:message — Bot によるメッセージ送信
• im:message:send_as_bot — Bot としてメッセージを送信

ライセンス

MIT