영어 | 중문
⚠️ 베타 버전 안내 : 이 도구는 현재 베타 단계입니다. 기능 및 API가 변경될 수 있으니, 버전 출시에 대한 최신 정보를 확인해 주세요.
이는 사용자가 Feishu/Lark 플랫폼에 빠르게 연결하고 AI 에이전트와 Feishu/Lark 간의 효율적인 협업을 지원할 수 있도록 설계된 Feishu/Lark 공식 OpenAPI MCP(Model Context Protocol) 도구입니다. 이 도구는 Feishu/Lark Open Platform API 인터페이스를 MCP 도구로 캡슐화하여 AI 비서가 이러한 인터페이스를 직접 호출하고 문서 처리, 대화 관리, 일정 예약 등 다양한 자동화 시나리오를 구현할 수 있도록 지원합니다.
지원되는 모든 Feishu/Lark 도구의 전체 목록은 tools.md 에서 확인할 수 있으며, 여기서 도구는 설명과 함께 프로젝트 및 버전별로 분류됩니다.
lark-mcp 도구를 사용하기 전에 Feishu/Lark 애플리케이션을 만들어야 합니다.
자세한 애플리케이션 생성 및 구성 지침은 Feishu 오픈 플랫폼 문서 - 애플리케이션 생성 또는 Lark 오픈 플랫폼 문서를 참조하세요.
lark-mcp 도구를 사용하기 전에 Node.js 환경을 설치해야 합니다.
lark-mcp 도구를 전역적으로 설치합니다.
Trae, Cursor 또는 Claude와 같은 AI 도구에 Feishu/Lark 기능을 통합하려면 구성 파일에 다음을 추가하세요.
사용자 ID로 API에 액세스하려면 사용자 액세스 토큰을 추가할 수 있습니다.
기본적으로 MCP 서비스는 공통 API를 활성화합니다. 다른 도구나 특정 API 또는 프리셋만 활성화하려면 -t 매개변수(쉼표로 구분)를 사용하여 지정할 수 있습니다.
다음 표에서는 각 API 도구와 다양한 사전 설정 컬렉션에 포함된 내용을 자세히 설명하여 필요에 맞는 적절한 사전 설정을 선택하는 데 도움을 줍니다.
| 도구 이름 | 기능 설명 | 사전 설정.기본값(기본값) | 프리셋.im.default | 프리셋.베이스.디폴트 | 프리셋.베이스.배치 | 사전 설정.doc.기본값 | 사전 설정.작업.기본값 | 사전 설정.캘린더.기본값 |
|---|---|---|---|---|---|---|---|---|
| im.v1.chat.create | 그룹 채팅 만들기 | ✓ | ✓ | |||||
| im.v1.chat.list | 그룹 채팅 목록 가져오기 | ✓ | ✓ | |||||
| im.v1.chatMembers.get | 그룹 멤버를 얻으세요 | ✓ | ✓ | |||||
| im.v1.message.create | 메시지 보내기 | ✓ | ✓ | |||||
| im.v1.메시지.목록 | 메시지 목록 가져오기 | ✓ | ✓ | |||||
| bitable.v1.app.create | 베이스 생성 | ✓ | ✓ | ✓ | ||||
| bitable.v1.appTable.create | 기본 데이터 테이블 생성 | ✓ | ✓ | ✓ | ||||
| bitable.v1.appTable.list | 기본 데이터 테이블 목록 가져오기 | ✓ | ✓ | ✓ | ||||
| bitable.v1.appTableField.list | 기본 데이터 테이블 필드 목록 가져오기 | ✓ | ✓ | ✓ | ||||
| bitable.v1.appTableRecord.search | 검색 기반 데이터 테이블 레코드 | ✓ | ✓ | ✓ | ||||
| bitable.v1.appTableRecord.create | 기본 데이터 테이블 레코드 생성 | ✓ | ✓ | |||||
| bitable.v1.appTableRecord.batchCreate | 기본 데이터 테이블 레코드 일괄 생성 | ✓ | ||||||
| bitable.v1.appTableRecord.update | 기본 데이터 테이블 레코드 업데이트 | ✓ | ✓ | |||||
| bitable.v1.appTableRecord.batchUpdate | 일괄 업데이트 기본 데이터 테이블 레코드 | ✓ | ||||||
| docx.v1.document.rawContent | 문서 내용 가져오기 | ✓ | ✓ | |||||
| docx.builtin.import | 문서 가져오기 | ✓ | ✓ | |||||
| docx.builtin.search | 문서 검색 | ✓ | ✓ | |||||
| drive.v1.permissionMember.create | 공동작업자 권한 추가 | ✓ | ✓ | |||||
| wiki.v2.space.getNode | 위키 노드 가져오기 | ✓ | ✓ | |||||
| 위키.v1.노드.검색 | 위키 노드 검색 | ✓ | ✓ | |||||
| 연락처.v3.user.batchGetId | 일괄 사용자 ID 가져오기 | ✓ | ||||||
| task.v2.task.create | 작업 생성 | ✓ | ||||||
| task.v2.task.patch | 작업 수정 | ✓ | ||||||
| task.v2.task.addMembers | 작업 멤버 추가 | ✓ | ||||||
| task.v2.task.addReminders | 작업 알림 추가 | ✓ | ||||||
| calendar.v4.calendarEvent.create | 캘린더 이벤트 만들기 | ✓ | ||||||
| calendar.v4.calendarEvent.patch | 캘린더 이벤트 수정 | ✓ | ||||||
| calendar.v4.calendarEvent.get | 캘린더 이벤트 가져오기 | ✓ | ||||||
| 캘린더.v4.잔여시간.목록 | 사용 가능/사용 중 상태 쿼리 | ✓ | ||||||
| calendar.v4.calendar.primary | 기본 캘린더 가져오기 | ✓ |
참고 : 표에서 "✓" 표시는 해당 도구가 해당 사전 설정에 포함되어 있음을 나타냅니다.
-t preset.xxx명령을 사용하면 해당 열에 "✓" 표시가 있는 도구만 활성화됩니다.
lark-mcp mcp 도구는 유연한 MCP 서비스 구성을 위한 다양한 명령줄 매개변수를 제공합니다.
| 매개변수 | 짧은 | 설명 | 예 |
|---|---|---|---|
--app-id | -a | Feishu/Lark 애플리케이션 앱 ID | -a cli_xxxx |
--app-secret | -s | 페이슈/라크 앱 앱 시크릿 | -s xxxx |
--domain | -d | Feishu/Lark API 도메인, 기본값은 https://open.feishu.cn 입니다. | -d https://open.larksuite.com |
--tools | -t | 쉼표로 구분된 활성화할 API 도구 목록 | -t im.v1.message.create,im.v1.chat.create |
--tool-name-case | -c | 도구 이름 형식, 옵션은 뱀, 낙타, 점 또는 케밥이며 기본값은 뱀입니다. | -c camel |
--language | -l | 도구 언어, 옵션은 zh 또는 en이며 기본값은 en입니다. | -l zh |
--user-access-token | -u | 사용자로서 API를 호출하기 위한 사용자 액세스 토큰 | -u u-xxxx |
--token-mode | API 토큰 유형, 옵션은 auto, tenant_access_token 또는 user_access_token이며 기본값은 auto입니다. | --token-mode user_access_token | |
--mode | -m | 전송 모드, 옵션은 stdio 또는 sse이며 기본값은 stdio입니다. | -m sse |
--host | SSE 모드에서 수신 호스트, 기본값은 localhost입니다. | --host 0.0.0.0 | |
--port | -p | SSE 모드에서 수신 포트, 기본값은 3000입니다. | -p 3000 |
--config | 구성 파일 경로, JSON 형식 지원 | --config ./config.json | |
--version | -V | 버전 번호 표시 | -V |
--help | -h | 도움말 정보 표시 | -h |
참고 : 사용자 액세스 토큰은 Feishu Open Platform의 인증 절차 또는 Lark Open Platform의 인증 절차를 통해 획득하거나, API 디버깅 콘솔을 사용하여 획득할 수 있습니다. 사용자 액세스 토큰을 사용하면 해당 사용자의 ID로 API 호출이 수행됩니다.
참고 : 이 옵션을 사용하면 API를 호출할 때 사용할 토큰 유형을 명시적으로 지정할 수 있습니다.
auto모드(기본값)는 API를 호출할 때 LLM에 의해 결정됩니다.
참고 :
-t매개변수는 다음과 같은 사전 설정 도구 컬렉션을 지원합니다.
preset.default- 모든 사전 설정 도구가 포함된 기본 도구 세트preset.im.default- 그룹 관리, 메시지 전송 등 인스턴트 메시징 관련 도구preset.bitable.default- 테이블 생성, 레코드 관리 등 Bitable 관련 도구preset.bitable.batch- 일괄 생성 및 레코드 업데이트 기능을 포함한 Bitable 일괄 작업 도구preset.doc.default- 문서 내용 읽기, 권한 관리 등 문서 관련 도구preset.task.default- 작업 생성, 멤버 관리 등 작업 관리 관련 도구preset.calendar.default- 캘린더 이벤트 생성, 여유/바쁨 상태 조회 등의 캘린더 이벤트 관리 도구입니다.
참고 : 언어를 중국어(
-l zh)로 설정하면 토큰 사용량이 늘어날 수 있습니다. 대규모 언어 모델과 통합할 때 토큰 제한 문제가 발생하면 기본 영어 설정(-l en)을 사용하는 것이 좋습니다.
참고 : 도구 이름 형식을 설정하면 MCP에 도구 이름이 표시되는 방식을 변경할 수 있습니다. 예를 들어,
im.v1.message.create다른 형식으로 변경할 수 있습니다.
- 뱀 형식(기본값):
im_v1_message_create- camel 형식:
imV1MessageCreate- 케밥 형식:
im-v1-message-create- dot 형식:
im.v1.message.create
명령줄 매개변수 외에도 JSON 형식 구성 파일을 사용하여 매개변수를 설정할 수 있습니다.
구성 파일 예(config.json):
참고 : 명령줄 매개변수는 구성 파일보다 우선합니다. 명령줄 매개변수와 구성 파일을 모두 사용하는 경우, 명령줄 매개변수가 구성 파일의 해당 설정보다 우선합니다.
lark-mcp는 두 가지 전송 모드를 지원합니다.
시작 후 SSE 엔드포인트는 http://<host>:<port>/sse 에서 액세스할 수 있습니다.
chcp 65001 실행하여 명령줄 인코딩을 UTF-8로 변경하세요. PowerShell을 사용하는 경우 터미널 글꼴이나 PowerShell 구성을 변경해야 할 수 있습니다.sudo npm install -g @larksuiteoapi/lark-mcp 사용하여 설치하거나 npm 전역 설치 경로의 권한을 수정하세요. Windows 사용자는 명령 프롬프트를 관리자 권한으로 실행해 보세요.-t 사용하여 활성화된 API 수를 줄이거나 더 큰 토큰을 지원하는 모델(예: claude3.7)을 사용해 보세요.이 도구를 개선하는 데 도움이 되는 문제점을 알려주시면 감사하겠습니다. 질문이나 제안 사항이 있으시면 GitHub 저장소에 올려주세요.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
AI 어시스턴트가 문서 처리, 대화 관리, 일정 예약과 같은 자동화 시나리오를 위해 Feishu/Lark API 인터페이스를 직접 호출할 수 있도록 하는 툴킷입니다.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/larksuite/lark-openapi-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server