Lark Mcp Server

Feishu/Lark OpenAPI MCP

英語 | 中文

開発者向けドキュメント検索 MCP

公式ドキュメント

トラブルシューティング

⚠️ ベータ版に関するお知らせ：このツールは現在ベータ版です。機能や API が変更される場合があるため、バージョンのリリース情報を随時ご確認ください。

これは Feishu/Lark 公式の OpenAPI MCP（Model Context Protocol）ツールです。ユーザーが Feishu/Lark プラットフォームにすばやく接続し、AI エージェントと Feishu/Lark の効率的な連携を実現できるように設計されています。このツールは Feishu/Lark Open Platform の API インターフェースを MCP ツールとしてカプセル化しており、AI アシスタントがこれらのインターフェースを直接呼び出して、ドキュメント処理、会話管理、カレンダーの予定調整など、さまざまな自動化シナリオを実現できます。

準備

Feishu/Lark アプリケーションの作成

lark-mcp ツールを使用する前に、Feishu/Lark アプリケーションを作成する必要があります。

1. Feishu Open Platform または Lark Open Platform にアクセスしてログインします
2. 「コンソール」をクリックして、新しいアプリケーションを作成します
3. App ID と App Secret を取得します。これらは API 認証に使用します
4. 使用するシナリオに応じて、アプリケーションに必要な権限を追加します
5. ユーザーとして API を呼び出す必要がある場合は、OAuth 2.0 のリダイレクト URL を http://localhost:3000/callback に設定します

アプリケーションの作成と設定の詳しい手順については、Feishu Open Platform ドキュメント - アプリケーションの作成を参照してください。

Node.js のインストール

lark-mcp ツールを使用する前に、Node.js 環境をインストールする必要があります。

公式インストーラーを使用する（推奨）：

1. Node.js のウェブサイトにアクセスします
2. LTS バージョンをダウンロードしてインストールします
3. インストール後、ターミナルで次のコマンドを実行して確認します：

node -v
npm -v

クイックスタート

Trae/Cursor/Claude での使用

Trae、Cursor、Claude などの AI ツールに Feishu/Lark の機能を統合するには、以下のボタンを使用してインストールしてください。

または、設定ファイルに以下を追加してください。

{
  "mcpServers": {
    "lark-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@larksuiteoapi/lark-mcp",
        "mcp",
        "-a",
        "<your_app_id>",
        "-s",
        "<your_app_secret>"
      ]
    }
  }
}

ユーザーの本人確認情報で API にアクセスする必要がある場合は、まずターミナルでログインコマンドを実行してログインしてください。開発者コンソールでアプリケーションのリダイレクト URL を事前に設定する必要があります。デフォルトは http://localhost:3000/callback です。

# Login and get user access token
npx -y @larksuiteoapi/lark-mcp login -a cli_xxxx -s yyyyy
   
# Or optionally, login with specific OAuth scope - if not specified, all permissions will be authorized by default
npx -y @larksuiteoapi/lark-mcp login -a cli_xxxx -s yyyyy --scope offline_access docx:document

次に、設定ファイルに以下を追加してください。

{
  "mcpServers": {
    "lark-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@larksuiteoapi/lark-mcp",
        "mcp",
        "-a",
        "<your_app_id>",
        "-s",
        "<your_app_secret>",
        "--oauth",
        "--token-mode", "user_access_token"
      ]
    }
  }
}

注：--oauth を有効にする場合は、--token-mode を user_access_token に明示的に設定することをおすすめします。これは、ユーザーアクセストークンで API を呼び出す設定であり、ユーザーのリソースへのアクセスや、個人のドキュメントの読み取り、IM メッセージの送信など、ユーザーの認可が必要なシナリオに適しています。デフォルトの auto のままにすると、一部の API では AI が tenant_access_token にフォールバックする場合があり、権限不足やユーザーのプライベートデータにアクセスできない問題が発生する可能性があります。

ドメインの設定

利用シナリオに応じて、lark-mcp では異なるドメイン環境を設定できます。

Feishu（中国版）：

• デフォルトでは https://open.feishu.cn ドメインを使用します
• 中国のユーザーに適しています

Lark（国際版）：

• https://open.larksuite.com ドメインを使用します
• 海外のユーザー、または Lark の国際版を利用するユーザーに適しています

Lark の国際版に切り替えるには、設定に --domain パラメーターを追加してください。

{
  "mcpServers": {
    "lark-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@larksuiteoapi/lark-mcp",
        "mcp",
        "-a",
        "<your_app_id>",
        "-s",
        "<your_app_secret>",
        "--domain",
        "https://open.larksuite.com"
      ]
    }
  }
}

💡 ヒント：対応するドメイン環境のオープンプラットフォームでアプリケーションが作成されていることを確認してください。国際版のアプリケーションは Feishu 中国版では使用できず、その逆も同様です。

API のカスタム設定

⚠️ ファイルのアップロード／ダウンロード：ファイルのアップロードとダウンロード操作は、まだサポートされていません。

⚠️ ドキュメントの編集：Feishu のクラウドドキュメントを直接編集することはできません（インポートと読み取りのみ可能です）。

デフォルトでは、MCP サービスで一般的な API が有効になっています。ほかのツールを有効にする場合や、特定の API またはプリセットのみを有効にする場合は、MCP クライアントの設定（JSON）で -t パラメーターを指定してください。

{
  "mcpServers": {
    "lark-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@larksuiteoapi/lark-mcp",
        "mcp",
        "-a", "<your_app_id>",
        "-s", "<your_app_secret>",
        "-t", "im.v1.message.create,im.v1.message.list,im.v1.chat.create,preset.calendar.default"
      ]
    }
  }
}

すべてのプリセットツールコレクションと、各プリセットに含まれるツールの詳細については、プリセットツールコレクションのリファレンスを参照してください。

サポートされている Feishu/Lark ツールの完全な一覧は、tools.mdを参照してください。

⚠️ 注意：プリセット以外の API は互換性テストを実施していないため、AI がそれらを理解して使用する際に、最適な動作をしない場合があります。

開発時の統合

開発者は、エージェントとの統合に関する最小限のサンプルとして、lark-samples/mcp_quick_demoを参照できます。

Lark ボットとの統合例として、lark-samples/mcp_larkbot_demo/nodejsも参照できます。

この例では、MCP の機能を Feishu/Lark ボットに統合し、ボットとの会話を通じてツール呼び出しやメッセージ送信を実行する方法を示します。既存のツールをボットに統合するシナリオに適しています。

高度な設定

詳細な設定オプションとデプロイシナリオについては、設定ガイドを参照してください。

利用可能なすべてのコマンドラインパラメーターとその使用方法について詳しくは、コマンドラインリファレンスを参照してください。

FAQ

• FAQ（よくある質問）
• 一般的な問題とユースケース

関連リンク

• Feishu オープンプラットフォーム
• 開発ドキュメント：OpenAPI MCP
• Lark 国際版オープンプラットフォーム
• Feishu オープンプラットフォーム API ドキュメント
• Node.js ウェブサイト
• npm ドキュメント

フィードバック

このツールの改善に役立つ課題の報告を歓迎します。質問や提案がある場合は、GitHub リポジトリに投稿してください。