Cursor接入飞书MCP Server教程

18 阅读2分钟

面对产品给的密密麻麻的需求文档,以前总是一点点复制到聊天框中,发送给AI进行功能的实现,操作繁琐且效率低。mcp的出现让我们开发者可以借助外部提供的工具,让AI能够直接和外部通信,提高写提示词的效率。本文就记录在windows系统中,Cursor接入飞书mcp的步骤,让我们开发的时候AI可以直接和需求文档通信。

一、环境准备

Node环境

需要在电脑上安装node,没有装的可前往Node官网进行下载。

工具准备

需要全局安装lark-mcp

npm install -g @larksuiteoapi/lark-mcp

验证安装是否成功

lark-mcp -V

安装成功会显示当前版本号

image.png

二、飞书创建应用

前往飞书开放平台创建飞书应用,点击这里本地调用 OpenAPI MCP - 飞书 CLI - 开发文档 - 飞书开放平台

然后前往开发者后台,创建应用

image.png

image.png

创建成功会生成凭据,后面配置要用于API身份验证

image.png

可以根据自己的应用场景开通对应的权限

image.png

然后点击发布应用,等待发布成功即可。

接着回到开发者文档,在右侧随便输入一个接口api,点击获取token

image.png

弹出授权界面,点击授权即可。成功之后会把输入框中的输入的接口url替换为生成的token。

image.png

token是有有效期的,所以当mcp不可用的时候可以上后台再用同样的操作获取token。(当然,mcp不可用的原因有多种,也有可能需要更新larksuiteoapi/lark-mcp包,具体要看错误输出,如果一开始配置成功,后续不可用,一般就是这2种情况。)

三、Cursor配置mcp

打开Cursor,打开设置,点击创建新的mcp服务

image.png

粘贴以下json配置,其中用<>标记的都是要替换成创建飞书应用时对应生成凭证

{
    "mcpServers": {
        "feishu-lark-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@larksuiteoapi/lark-mcp",
                "mcp",
                "-a",
                "<app id>",
                "-s",
                "<app secret>",
                "-u",
                "<token>"
            ]
        }
    }
}

保存后如果Cursor显示了绿色圆点,表示配置成功

image.png

所有的步骤已完成,来验证下Cursor能否根据飞书文档链接读取内容:

image.png

AI返回读取不了文档内容,原因是没开通对权限。根据AI提示前往开通对应的文档权限即可。

image.png

最后再试一次,AI能成功读取并总结了文档内容。