Feishu (Lark)

🚀 使用指南

このドキュメントは、システムのインストール、設定、接続、使用方法、権限設定、問題解決などの手順を詳細に説明しています。

📦 インストール

1. リポジトリをクローンします。
2. pnpm install を実行して依存関係をインストールします。
3. .env.example を .env にコピーし、飛書アプリの認証情報を入力します。
4. pnpm run dev を使用してサーバーを起動します。コマンドライン引数を使用することもできます。

🛠️ 設定ガイド

環境変数の設定

• FEISHU_APP_ID：飛書アプリのID（必須）
• FEISHU_APP_SECRET：飛書アプリのシークレットキー（必須）
• PORT：サーバーが実行されるポート。デフォルトは 3333 です。

コマンドライン引数

• --version：バージョン番号を表示します。
• --feishu-app-id：飛書アプリのIDを指定します。
• --feishu-app-secret：飛書アプリのシークレットキーを指定します。
• --port：サーバーのポートを指定します。
• --stdio：サーバーをコマンドラインモードで実行します。
• --help：ヘルプ情報を表示します。

🔗 接続設定

1. Cursorの設定を開きます。
2. Settings > AI > MCP Servers に移動します。
3. 新しいサーバーを追加し、URLを http://localhost:3333（またはカスタムポート）に設定します。
4. "Verify Connection" をクリックして接続状態を確認します。

💻 使用例

基本的な使用法

1. CursorでAIパネルを開きます（デフォルトのショートカットキー：Cmd+K または Ctrl+K）。
2. 新しい飛書ドキュメントを作成する場合は、folderTokenを指定する必要があります。たとえば、フォルダのリンクを訪問します：https://vq5xxxxx7bc.feishu.cn/drive/folder/FPKvfjdxxxxx706RnOc
3. ドキュメントの内容を変更する場合は、具体的なドキュメントのリンクを提供する必要があります。たとえば：https://vq5ixxxx7bc.feishu.cn/docx/J6T0d6exxxxxxxDdc1zqwnph
4. 質問またはドキュメント内容に基づく操作を要求します。

🔑 権限設定と問題解決

権限の種類

• ロボット権限
• ドキュメントアクセス権限

権限の検証と問題解決

1. トークンを取得します：https://open.feishu.cn/api-explorer/cli_a75a8ca0ac79100c?apiName=tenant_access_token_internal&from=op_doc&project=auth&resource=auth&version=v3
2. トークンを使用してドキュメントのアクセス権限を検証します：https://open.feishu.cn/api-explorer/cli_a7582508c93ad16b?apiName=tenant_access_token_internal&from=op_doc&project=auth&resource=auth&version=v3

注意事項

⚠️ 重要提示

• アプリが十分な権限を持っていることを確認してください。
• ドキュメントのリンクが正しいことを確認してください。
• コンソールの出力ログを確認してください。

📚 追加情報

• サポートされているコマンドラインツール：pnpm、npm
• 設定例：.env ファイルの内容
• デバッグガイド：問題の解決方法