feishu-user-plugin — MCP-сервер для Claude Code
MCP-сервер и CLI для Feishu/Lark: 85 инструментов, три слоя авторизации, отправка сообщений от имени пользователя через cookie и protobuf.
claude mcp add --env LARK_COOKIE=<LARK_COOKIE> --env LARK_APP_ID=<LARK_APP_ID> --env LARK_APP_SECRET=<LARK_APP_SECRET> --env LARK_USER_ACCESS_TOKEN=<LARK_USER_ACCESS_TOKEN> --env LARK_USER_REFRESH_TOKEN=<LARK_USER_REFRESH_TOKEN> --transport stdio feishu-user-plugin -- npx -y feishu-user-pluginЧто делает feishu-user-plugin
Сервер закрывает IM, документы,多维表格, базу знаний, облачное пространство, календарь, задачи v2, OKR и живые события. Всего 85 инструментов и 9 MCP-промптов, которые работают как слэш-команды: /send, /reply, /digest, /search, /doc, /table, /wiki, /drive и /status. Авторизация разделена на три независимых слоя, и настраивать все сразу не нужно — работает тот, для которого есть учётные данные. Cookie-слой даёт отправку текста и rich-text post от имени пользователя, официальный API робота открывает чтение и запись в группах, документах и таблицах, а пользовательский OAuth UAT нужен для чтения личных переписок и владения созданными ресурсами.
Установка идёт через npx feishu-user-plugin setup --app-id <APP_ID> --app-secret <APP_SECRET>, затем npx feishu-user-plugin oauth для получения пользовательского токена. После этого клиент перезапускают. Cookie живёт 12–24 часа без heartbeat, поэтому периодически придётся заходить на feishu.cn и забирать его заново. Протокольный слой зависит от web-клиента Feishu: обновление на их стороне может его сломать, хотя возможности робота это не затрагивает.
Отправка изображений и файлов от имени пользователя устроена хитрее: сам запрос идёт через cookie, но image_key и file_key сначала нужно получить через официальный API (upload_image, upload_file). Карточки через cookie-канал сервер не пропускает — они всегда уходят от робота.
Какие задачи решает
- отправить сообщение в Feishu от своего имени без создания приложения
- прочитать личные переписки и список чатов пользователя
- собрать дайджест обсуждения в группе за нужный период
- загрузить и разобрать документ или多维表格 через агента
- переключаться между несколькими аккаунтами Feishu на одной машине
Примеры запросов агенту
- Отправь от моего имени в Feishu сообщение: ревью посмотрел, есть три замечания
- Прочитай сообщения в группе «工程组» за сегодня и сделай дайджест
- Проверь статус всех трёх слоёв авторизации через
/status
Как установить feishu-user-plugin
Командой платформы
claude mcp add --env LARK_COOKIE=<LARK_COOKIE> --env LARK_APP_ID=<LARK_APP_ID> --env LARK_APP_SECRET=<LARK_APP_SECRET> --env LARK_USER_ACCESS_TOKEN=<LARK_USER_ACCESS_TOKEN> --env LARK_USER_REFRESH_TOKEN=<LARK_USER_REFRESH_TOKEN> --transport stdio feishu-user-plugin -- npx -y feishu-user-pluginВместо <…> подставьте свои значения
Командой платформы
codex mcp add feishu-user-plugin --env LARK_COOKIE=<LARK_COOKIE> --env LARK_APP_ID=<LARK_APP_ID> --env LARK_APP_SECRET=<LARK_APP_SECRET> --env LARK_USER_ACCESS_TOKEN=<LARK_USER_ACCESS_TOKEN> --env LARK_USER_REFRESH_TOKEN=<LARK_USER_REFRESH_TOKEN> -- npx -y feishu-user-pluginВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"feishu-user-plugin": {
"command": "npx",
"args": [
"-y",
"feishu-user-plugin"
],
"env": {
"LARK_COOKIE": "<LARK_COOKIE>",
"LARK_APP_ID": "<LARK_APP_ID>",
"LARK_APP_SECRET": "<LARK_APP_SECRET>",
"LARK_USER_ACCESS_TOKEN": "<LARK_USER_ACCESS_TOKEN>",
"LARK_USER_REFRESH_TOKEN": "<LARK_USER_REFRESH_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"feishu-user-plugin": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"feishu-user-plugin"
],
"env": {
"LARK_COOKIE": "<LARK_COOKIE>",
"LARK_APP_ID": "<LARK_APP_ID>",
"LARK_APP_SECRET": "<LARK_APP_SECRET>",
"LARK_USER_ACCESS_TOKEN": "<LARK_USER_ACCESS_TOKEN>",
"LARK_USER_REFRESH_TOKEN": "<LARK_USER_REFRESH_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e LARK_COOKIE=<LARK_COOKIE> -e LARK_APP_ID=<LARK_APP_ID> -e LARK_APP_SECRET=<LARK_APP_SECRET> -e LARK_USER_ACCESS_TOKEN=<LARK_USER_ACCESS_TOKEN> -e LARK_USER_REFRESH_TOKEN=<LARK_USER_REFRESH_TOKEN> feishu-user-plugin npx -y feishu-user-pluginВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о feishu-user-plugin
Как установить feishu-user-plugin в Claude Code?
Добавьте сервер командой `claude mcp add feishu-user-plugin -e LARK_COOKIE=<LARK_COOKIE> -e LARK_APP_SECRET=<LARK_APP_SECRET> -e LARK_USER_ACCESS_TOKEN=<LARK_USER_ACCESS_TOKEN> -e LARK_USER_REFRESH_TOKEN=<LARK_USER_REFRESH_TOKEN> -- npx -y feishu-user-plugin`, затем перезапустите Claude.
Что делает feishu-user-plugin?
Это MCP-сервер и CLI для Feishu/Lark с 85 инструментами: отправка сообщений от имени пользователя, чтение групп и личных чатов, работа с документами,多维表格, базой знаний, календарём, задачами v2, OKR и живыми событиями.
Нужно ли создавать приложение Feishu для работы сервера?
Для отправки текста и rich-text post от имени пользователя через cookie — нет. Для чтения групп, документов, таблиц, календаря, задач и OKR нужны LARK_APP_ID и LARK_APP_SECRET от自建 приложения.
