Feishu-MCP
MCP-сервер для Feishu и Lark: агент читает и правит документы блоками, ведет задачи и ищет коллег, а набор инструментов доступен и как CLI
- 746 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Создает, меняет и удаляет блоки документов и задачи в вашей организации, в режиме `user` от вашего имени
- Хранит `FEISHU_APP_SECRET` и OAuth-токены пользователей, а в HTTP-режиме без токена доступа эндпоинты открыты любому, кто видит порт
- Содержимое корпоративных документов попадает в контекст модели
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/feishu-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Создает, меняет и удаляет блоки документов и задачи в вашей организации, в режиме `user` от вашего имени
- Хранит `FEISHU_APP_SECRET` и OAuth-токены пользователей, а в HTTP-режиме без токена доступа эндпоинты открыты любому, кто видит порт
- Содержимое корпоративных документов попадает в контекст модели
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Feishu-MCP подключает агента к документам, wiki, папкам и задачам Feishu и Lark. Агент читает документ по блокам, создает новый, меняет текст отдельных блоков, удаляет лишнее и ищет документы по ключевым словам. Он собирает таблицы, вставляет локальные и удаленные картинки, формулы и диаграммы Mermaid, а команда `import_markdown_to_feishu_document` превращает текст Markdown в документ или страницу базы знаний. Права зависят от режима входа. При `FEISHU_AUTH_TYPE=tenant` сервер работает от имени приложения. При `user` он действует от вашего имени через OAuth, и только в этом режиме открываются задачи (список своих, создание вместе с подзадачами, обновление, удаление) и поиск сотрудников по имени. Нужные модули выбирает переменная `FEISHU_ENABLED_MODULES`: `document`, `task`, `calendar`, `member` или `all`. Те же инструменты работают без сервера. Пакет ставит команду `feishu-tool`, например `feishu-tool create_feishu_document '{"title": "Тест"}'`, и ее вызывают из терминала, скриптов или самого агента. Для связки с Claude Code автор ведет отдельный репозиторий Feishu-Skill.
Для кого. Для команд, которые ведут документы и задачи в Feishu или Lark и хотят, чтобы Cursor, Cline, Claude Code и другие агенты писали и правили их напрямую.
Подходит, если
- Агент должен выгрузить в Feishu готовое описание проекта из Markdown: импорт идет в документ или в wiki
- Нужно собрать в документе таблицу, схему процесса Mermaid и формулы без ручной верстки
- Задачи из обсуждения надо завести в Feishu вместе с подзадачами и исполнителями (режим `user`)
- Из большого каталога документов требуется найти нужный по ключевым словам и пересказать его содержимое
- Скрипту или CI нужны те же операции без запуска MCP-сервера, для этого есть `feishu-tool`
Не подходит, если
- Ваша команда работает в Notion, Confluence или Google Docs: сервер говорит только с API Feishu и Lark
- Нужна работа с календарем: модуль `calendar` еще в разработке
- Администратор организации запретил создавать собственные приложения Feishu: без приложения нет ключей `FEISHU_APP_ID` и `FEISHU_APP_SECRET`
- Требуется официальный клиент от вендора: у Lark есть свой CLI, а этот сервер ведет сторонний автор
Пример запроса к агенту
Создай в Feishu документ «План релиза» из файла docs/release.md и заведи по его пунктам задачи на меняMCP
- Транспорт
- stdio, http, sse
- Авторизация
- API-ключ
Переменные окружения
FEISHU_APP_IDобязательная- Идентификатор приложения из консоли разработчика Feishu.
FEISHU_APP_SECRETобязательная, секрет- Секрет того же приложения.
FEISHU_AUTH_TYPE- Режим входа: `tenant` (по умолчанию, от имени приложения) или `user` (от вашего имени, OAuth).
FEISHU_ENABLED_MODULES- Включенные модули: `document` по умолчанию, также `task`, `calendar`, `member`, `all`.
FEISHU_USER_KEY- Идентификатор пользователя для режимов stdio и CLI при авторизации `user`.
MCP_BEARER_TOKENсекрет- Если задан, HTTP и SSE эндпоинты требуют заголовок `Authorization: Bearer`.
Ограничения
- Нужно зарегистрировать приложение в консоли Feishu, выдать ему права и получить `FEISHU_APP_ID` и `FEISHU_APP_SECRET`. Пошаговая инструкция лежит в `FEISHU_CONFIG.md` репозитория.
- Документация и интерфейс приложения на китайском. Для международного Lark задайте `FEISHU_BASE_URL=https://open.larksuite.com/open-apis` и `FEISHU_AUTH_BASE_URL=https://accounts.larksuite.com`.
- В режиме HTTP или SSE токены пользователей хранятся на сервере. Шифрование токенов включает переменная `FEISHU_ENCRYPTION_KEY`, без нее они хранятся без шифрования.
Как отключить. Уберите блок `feishu-mcp` из конфигурации MCP вашего агента и перезапустите его. Если ставили CLI глобально, выполните `npm uninstall -g feishu-mcp`. Токены пользователей, которые сервер сохранил, удалите в консоли Feishu, отозвав доступ приложения.
Частые вопросы
Как подключить Feishu к Cursor через MCP?
Добавьте в конфигурацию MCP блок с командой `npx` и аргументами `-y feishu-mcp@latest --stdio`, а в `env` укажите `FEISHU_APP_ID`, `FEISHU_APP_SECRET`, `FEISHU_AUTH_TYPE` и `FEISHU_ENABLED_MODULES`. Ключи приложения выдает консоль разработчика Feishu.
Работает ли сервер с международным Lark?
Да, если сменить адреса. Задайте `FEISHU_BASE_URL=https://open.larksuite.com/open-apis` и `FEISHU_AUTH_BASE_URL=https://accounts.larksuite.com`, иначе сервер обращается к `open.feishu.cn`.
Почему агент не видит задачи?
Модуль задач работает только в режиме `user`. Укажите `FEISHU_AUTH_TYPE=user`, включите модуль через `FEISHU_ENABLED_MODULES=document,task` и пройдите OAuth-авторизацию. В режиме `tenant` инструменты задач недоступны.
Чем MCP-сервер отличается от feishu-tool?
Инструменты у них одинаковые, различается способ вызова. MCP-сервер подключают к агенту, а `feishu-tool` запускают командой в терминале или скрипте без сервера. Установка: `npm install -g feishu-mcp@latest`.
Как закрыть HTTP-эндпоинты сервера паролем?
Задайте переменную `MCP_BEARER_TOKEN`. После этого эндпоинты HTTP, SSE и Streamable HTTP требуют заголовок `Authorization: Bearer <токен>`. Без нее авторизация выключена, поэтому не открывайте порт в сеть.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыCLI для Feishu с двусторонней конвертацией Markdown и девятью скиллами: Claude Code ведет чаты, почту и календарь.
AFFiNE MCP Server — заметки и базы AFFiNE для агента
AFFiNE MCP Server
MCP-сервер для AFFiNE: агент ищет, создает и правит документы, базы и комментарии в облачном или своем AFFiNE
Плагин OpenClaw для Feishu и Lark: бот в личных и групповых чатах, работа с документами, вики, диском, задачами и таблицами
Официальный плагин Lark и Feishu для OpenClaw: чат, документы, таблицы, календарь и задачи компании из диалога с агентом
MCP-сервер для Kaiten с документами
kaiten-mcp
MCP-сервер для Kaiten на 66 инструментов, единственный из набора с поддержкой документов Kaiten и вложенных обсуждений в них
Cunzhi (寸止)
寸止 (Cunzhi)
MCP-сервер на Rust и Tauri: перед завершением ответа агент показывает окно с вариантами, хранит правила проекта и ищет по коду
Коротко о README
README на китайском перечисляет возможности по четырем группам: документы, задачи, пользователи и поиск. Затем идут таблица инструментов, примеры стилей, быстрый запуск через `npx` или Docker и описание CLI `feishu-tool`. Отдельный раздел разбирает переменные окружения и три способа подключения: stdio, SSE и HTTP Streamable. Подробная настройка приложения Feishu вынесена в `FEISHU_CONFIG.md`.