插件 · Lorca 文档

让智能体连接 GitHub、Jira、Notion、Stripe、浏览器等几十种服务。

插件为智能体提供某个服务或应用的工具。在底层，一个插件就是一个或多个 MCP 服务器。

市场

点按侧边栏右下角的市场图标（四个圆点），或选择 文件 › 市场…（⇧⌘M，Windows 和 Linux 上是 Ctrl+Shift+M）。最前面是 精选插件 和 精选智能体，然后按类别列出其余内容。精选分组下的 查看全部 会列出所有插件或所有智能体。搜索会同时查找插件和智能体。市场内容来自 lorca.app，所以新的插件和智能体无需更新 Lorca 就会出现。

市场里有这些插件：

类别	插件
效率	Linear、Notion、Atlassian（Jira 和 Confluence）、Google Calendar、Google Drive、Zapier、Todoist、ClickUp、Airtable、飞书、飞书项目、滴答清单、腾讯文档
通信	Slack、Gmail、Telegram、Granola、Fireflies、Resend
设计	Canva、Miro、Webflow、可灵
代码	GitHub、Sentry、Cloudflare、GitLab、Netlify、Railway、Expo
数据	Supabase、Neon、PostHog、Mixpanel、Amplitude
销售	Attio、Close、Apollo.io
财务	Stripe、PayPal、Mercury
研究	Context7（库文档）、Browser（由智能体操作的浏览器，见浏览器）、Exa（网页搜索）、DeepWiki、Hugging Face、秘塔 AI 搜索、知乎、高德地图
支持	Intercom

Browser、Context7、DeepWiki、Exa 和 Hugging Face 不需要账号。这里没有插件的应用，可以通过 Zapier 使用。Telegram，以及带机器人的 Slack 应用，还能让智能体在频道里回复别人。市场里的智能体是现成的队友，参见智能体；市场里的工作流可以一次把一件事设置好，参见工作流。

插件按 Runner 安装。那台电脑上的每个智能体都能使用它们，以各自的访问权限为限。密钥和登录状态留在那个 Runner 上；你的其他设备只看得到插件的名字和状态。

按需加载工具

每个回合开始时，智能体只会看到 Runner 上已安装插件的一份精简目录。只有任务确实需要某项能力时，Lorca 才连接对应的 MCP 服务器，并把匹配的工具结构交给模型。选中的工具会在本回合余下时间保持可用，无关插件的完整工具目录不会占用模型上下文。

安装插件

**在聊天里：**对智能体说“安装 GitHub 插件”。它会找到插件，并在安装任何东西之前发一张卡片征求你的许可。
**在应用里：**打开市场，点按插件旁边的添加。插件会安装在市场顶部显示的 Runner 上；如果你有多台 Runner，可以在那里换一台。智能体检查器里的 从插件中添加… 会在这个智能体的 Runner 上打开市场，设置 › 插件 则在工具栏里选中的 Runner 上打开。

你可以从手机给任何 Runner 安装插件。请求会加密送到那台电脑。

GitHub 会显示一个短代码和一个链接（在插件的面板里登录时，面板上也会显示）。在任何设备上到 github.com 输入代码即可。
其他服务会在你点登录的那台设备上打开登录页面：电脑上的浏览器，或者手机自己的浏览器。你可以在手机上替一台电脑上的插件完成登录，电脑前不用有人。

有些插件也接受直接粘贴的令牌，没有浏览器的 Runner 也能用：GitHub 的个人访问令牌，或者 Airtable、Cloudflare、Fireflies、Neon、PostHog、Resend、Stripe、Supabase、Zapier 的 API 密钥或令牌。Context7 和 Exa 可以填一个 API 密钥来提高免费额度，Hugging Face 的令牌则让插件用你自己的账号。在插件的面板里填写。密钥字段只能写入：保存之后不会再显示。

多个账号

Slack、Gmail、Google Calendar、Google Drive 和 Telegram 可以在同一台 Runner 上添加多个账号，每个账号有自己的名字：Gmail · 工作、Gmail · 个人。在市场里，服务的页面会列出它在所选 Runner 上的账号和状态（已接入、需要登录、需要更多权限、需要设置或无法连接）。添加，或者已有账号后的 添加账号…，会让你起个名字，然后打开新账号的面板，在那里改名、设置和登录。设置 › 插件 和智能体的检查器会把每个账号单独列一行。

智能体按名字使用各个账号，不确定你指的是哪一个时会问你。权限卡片、访问权限和调用上限都按账号区分。智能体引用邮件、日程、消息或文档时，会保留指向原文的链接。

这几个服务在第一次登录前，需要你自己的应用：

Gmail、Google Calendar、Google Drive： 你自己在 Google Cloud 里创建的桌面版 OAuth 客户端。一个客户端三个服务都能用，步骤见你自己的 Google 客户端。
Slack： 一个开启了 PKCE 的 Slack 应用，回调地址为 http://localhost:3118/callback，并且工作区已批准它使用 MCP。填入它的客户端 ID。要用频道的话，还要填它的机器人 token 和应用 token。
Telegram： BotFather 给的机器人 token。Telegram 用于频道。

显示 需要更多权限 的账号，是登录时缺了某个工具需要的授权：重新登录即可补上。登录过期或被撤销时，会提示你重新登录。

智能体写的邮件和 Slack 消息会先作为草稿，由你发送。

你自己的 Google 客户端

Gmail、Google Calendar 和 Google Drive 用你在自己的 Google Cloud 项目里创建的 OAuth 客户端登录。大约五分钟就能设置好，一个客户端三个服务都能用。

创建项目

在 Google Cloud 控制台打开项目选择器，选择新建项目，随便起个名字（比如 Lorca），点创建。

打开 API

在 API 和服务 › 库 里，打开你要用的 API：Gmail API、Google Calendar API 和 Google Drive API。

设置同意屏幕

在 Google Auth Platform 里点开始。填一个应用名称（比如 My Lorca），用户支持邮箱填你的邮箱，受众选外部，联系邮箱也填你的邮箱，同意 Google 的政策后点创建。

发布应用

在 Google Auth Platform › 受众群体 里点发布应用并确认。如果一直停在"测试"状态，只有你在那里列出的测试用户能登录，而且 Google 每七天会让他们重新登录一次。

创建客户端

在 Google Auth Platform › 客户端 里点创建客户端，应用类型选桌面应用，随便起个名字，点创建。复制客户端 ID 和客户端密钥，或者点下载 JSON：密钥只显示这一次。

在 Lorca 里添加账号

在市场里打开 Gmail（或 Google Calendar、Google Drive），点添加，给账号起个名字（比如"工作"）。在账号面板里把客户端 ID 填进 GOOGLE_CLIENT_ID，密钥填进 GOOGLE_CLIENT_SECRET，点保存。

"已阻止访问"或"不是测试用户"： 应用还在测试状态。发布它，或者在受众群体 › 测试用户里加上你自己。
提示某个 API "has not been used in project"： 到 API 和服务 › 库 里打开这个 API，等一分钟再试。
每周都要重新登录： 应用还在测试状态，发布它即可。

插件可以做什么

智能体使用插件，以它的访问权限为限。读取类操作立即执行。任何会改动东西的操作，比如创建 issue、发表评论、删除页面，都要经过自动审查，该问的时候会先问你。

管理插件

插件的面板会显示它的状态、登录、设置、调用上限（见上限）、你已经始终允许的操作（带还原），以及移除。市场里的插件会自动更新，并保留你的设置和登录状态。

你自己的 MCP 服务器

任何 MCP 服务器都可以当作插件：由 Runner 启动的命令，比如 npx -y @modelcontextprotocol/server-filesystem ~/Notes、uvx mcp-server-fetch 或 docker run；也可以是使用 streamable HTTP 的远程服务器的 URL。

设置 › 插件 会在 MCP 服务器 下列出工具栏里选中的 Runner 上的这些服务器。添加服务器… 需要一个名称，以及命令（和它的环境变量）或 URL（和它的请求头）。把服务器 README 中的 JSON，或 Claude Desktop、Cursor 的整个 mcpServers 配置块粘贴到任意一栏，表单就会读懂它；多个服务器会一次添加。保存之后，表单会显示服务器是否启动成功、提供了哪些工具，并提供 重新连接、关闭它的开关和移除。关闭的服务器会保留设置和登录信息，但智能体看不到它。

需要账号的远程服务器会在 Lorca 第一次连接时要求登录：服务器会显示 需要登录，在它的表单里或智能体发出的卡片上点登录，就会像市场插件一样通过 OAuth 登录；在它的表单里点 退出登录 会忘掉这次登录。如果服务器接受令牌，可以把令牌放在请求头里，比如 Authorization: Bearer …。

这些服务器保存在 Lorca 文件夹里的 mcp.json（~/.lorca/mcp.json），格式与 Claude Desktop、Cursor 和 Claude Code 相同，你可以从它们的配置里复制，也可以直接手动编辑。编辑之后，在 设置 › 插件 里它那一行点按 重新载入，或运行 lorca mcp reload：

{
  "mcpServers": {
    "notes": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/Notes"],
      "description": "我的笔记文件夹"
    },
    "linear": {
      "type": "http",
      "url": "https://mcp.linear.app/mcp"
    },
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": { "CONTEXT7_API_KEY": "${CONTEXT7_API_KEY}" },
      "disabled": true
    }
  }
}

${VAR} 会读取你的 shell 环境中的变量，${VAR:-default} 在变量没有值时使用默认值；值没有设置的请求头或变量会被省略。description 告诉智能体这个服务器的用途，cwd 是命令启动时所在的文件夹，timeout 是一次调用最多可以多少秒没有回应（不设置时为十分钟），"oauth": false 让远程服务器不要登录。Lorca 会保留它不认识的字段，也会保持你写的顺序。

想让智能体用不到服务器的某些工具，可以在服务器的表单里关掉它们旁边的开关，也可以像 pi 一样写在 toolExposure 里：{ "delete_*": "hidden", "delete_draft": "codemode" } 会隐藏名字以 delete_ 开头的所有工具，delete_draft 除外，因为写明的名字优先于模式。"exposure": "hidden" 会隐藏 toolExposure 没有写到的所有工具。

不支持即时注册应用的服务器，可以在 oauth 里使用你在它那里注册的应用：clientId、clientSecret（可以写成 ${SECRET}），以及注册时填写的 callbackPort 或 callbackUrl，这样的登录会在 Runner 自己的浏览器里打开。clientName 让 Lorca 用另一个名字注册，用于只接受它认识的名字的服务器；scope 请求更多权限；服务器指错授权服务器时，authServerMetadataUrl 指向正确的那个。服务器回复某次调用需要比当前登录更多的权限时，会请你重新登录，一并授予这些权限。

智能体按服务器的名称调用它的工具，比如 notes__read_file。读取类工具立即执行，其余的和其他插件一样要经过自动审查。提供资源（比如文件或记录）的服务器还会多出列出和读取资源的工具 notes__list_mcp_resources 和 notes__read_mcp_resource；二进制资源会存成文件，智能体可以打开。命令行管理的也是同一个文件：lorca mcp add、list、get、remove、reload、sign-out，以及从其他应用 import。

插件

本页目录