连接应用

Notion、Linear 等应用

为你自己或为团队连接 Notion、Linear、Atlassian、Figma、GitHub 等应用,让 AI 可以使用它们,以及每个应用需要的地址或密钥从哪里获取。

AI 可以替你使用 Trina AX 以外的应用:搜索你的 Notion 页面、打开一个 Linear 议题、读取一个 Jira 工单。每个应用只需连接一次。 大多数应用不需要复制任何东西:你在应用自己的页面上登录即可。少数应用(例如 GitHub)则会给你一个密钥。

注意

在 0.4.0 之前,这个页面叫作外部服务(External services)。这些连接使用的是 MCP,一种应用向 AI 提供工具的通用方式; 使用时你不需要了解更多。

#你的应用用哪种方式连接

应用你需要什么指南
Notion、Linear、Atlassian(Jira、Confluence)、Figma、Canva、Stripe、Supabase、Cloudflare、Higgsfield,以及发现中的其他应用你在那个应用中的账号。不需要复制任何东西登录“发现”中的应用
GitHub一个个人访问令牌GitHub
其他公布了“MCP server”地址的应用地址,以及应用要求时的密钥通过地址添加应用
公司自己的系统(API)地址、密钥和使用说明公司自己的 API
Google Drive、Gmail、日历、文档、表格你的 Google 账号Google 应用
Slack成员什么都不用做;管理员添加一次Slack

#为你自己还是为团队

为你自己为团队
在哪里设置 › 连接器管理 › 已连接的应用(所有者和管理员)
AI 用谁的账号你的登录的那个账号,或保存的那个密钥
谁使用只有你,在你自己的对话中管理员选择的所有人、小组或个人
谁能看到只有你,管理员看不到管理员

团队连接只登录一次,作为一个账号:所有使用它的人在那个应用中都以这个账号的身份操作。如果每个人应该以自己的身份操作(自己的 Notion 页面、自己的 GitHub 权限),请改为创建模板,或让每个人自己连接。

#登录“发现”中的应用

提示

你需要准备的

  • 你在那个应用(Notion、Linear……)中的账号,并已在浏览器中登录。
  • 不需要复制或粘贴任何东西:Trina AX 会自动填好应用的官方地址。
  1. 打开连接器

    点左侧栏底部你的头像,再点设置 › 连接器(在手机上是我标签页)。发现列出了你可以连接的应用。显示全部会列出所有应用; 搜索应用可以按名称查找。

    设置 › 连接器
  2. 打开应用并选择“连接”

    应用的页面会说明 AI 在那里能做什么,并列出它的工具。选择连接(或列表中的 +)。成员还会看到请管理员添加,用来请求为整个团队添加。

    Notion 的页面
  3. 保存并登录

    对话框会显示应用的官方地址。高级保持不变,选择保存并登录。

    添加 Notion
  4. 在应用的页面上允许访问

    一个新窗口会打开应用自己的页面(Notion、Linear……)。如有提示请登录,选择工作区,然后选择 Allow(按钮也可能叫 Continue 或 Accept)。窗口会关闭,Trina AX 显示已登录。应用会移到你的连接器中,并显示已连接。

为团队连接时,管理员在管理 › 已连接的应用中做同样的操作:打开应用并选择为团队连接。旁边的箭头还提供 作为模板:每位成员各自连接。然后选择谁可以使用它。

为团队连接 Notion

登录必须在电脑上完成,在浏览器或桌面应用中。连接好之后,在手机上也能用。

#GitHub

GitHub 不允许其他应用自己完成登录,所以要用个人访问令牌连接。只有所有者和管理员可以通过地址添加应用;成员请找管理员,管理员可以创建 模板,让每个人使用自己的令牌。

提示

你需要准备的

  • 地址:https://api.githubcopilot.com/mcp/(GitHub 的 MCP 服务器)。
  • 密钥:GitHub 的个人访问令牌,以 github_pat_ 开头。
  1. 在 GitHub 创建令牌

    打开 GitHub › Settings › Developer settings › Personal access tokens › Fine-grained tokens, 选择 Generate new token。填写名称(“Trina AX”)、到期日期、它可以打开的仓库(选 Only select repositories 最安全),以及 AI 需要的权限,例如把 Contents、Issues 和 Pull requests 设为 Read-only;如果允许 AI 修改,就设为 Read and write。 选择 Generate token 并复制它:GitHub 只显示一次。详情见 GitHub 的指南(英文)。

  2. 在 Trina AX 中添加

    在管理 › 已连接的应用中,选择通过地址添加(在“发现”下)或添加。填写:

    • 名称:GitHub
    • 地址:https://api.githubcopilot.com/mcp/
    • 打开高级,把登录方式设为 API密钥。
    • 密钥使用的请求头:保留 Authorization: Bearer(默认)。
    • 密钥:粘贴令牌。
    用令牌连接 GitHub
  3. 保存

    选择保存。Trina AX 会向 GitHub 核对令牌,并列出它提供的工具。这一行会显示已连接。

#通过地址添加应用

任何公布了“MCP server”地址的应用都可以添加,即使它不在“发现”中。所有者和管理员在管理 › 已连接的应用 › 通过地址添加中添加。 成员会看到“没有列出?请管理员添加。”

提示

你需要准备的

  • 地址:在应用的帮助页面中,通常是名为“MCP”“MCP server”或“Connect to AI tools”的页面。它以 https:// 开头, 通常以 /mcp 结尾。
  • 应用的登录方式:在它自己的页面上登录(登录(OAuth))、用密钥(API密钥),或不需要登录(无)。
  • 如果用密钥:密钥,在应用的设置中(“API keys”“Tokens”“Developer”)获取;如果应用的帮助写了请求头名称,例如 X-API-Key,还需要请求头名称。

对话框中的各项:

项目填什么
名称大家在对话中看到的名称,例如“GitHub”。
地址应用的 MCP 地址。以 https:// 开头。
由谁连接(高级)团队共用一个,或每位成员各自。
类型(高级)MCP服务器。只有普通的 Web API 才选 API:见公司自己的 API。
登录方式(高级)按应用的帮助选择登录(OAuth)、API密钥或无。
密钥使用的请求头保留 Authorization: Bearer(默认),除非应用的帮助写了别的请求头。那时选择其他请求头,并准确填写请求头名称。
密钥完整粘贴密钥。保存后就看不到了。
用我自己的应用登录(高级)只用于要求你创建自己的登录应用的应用,例如 Google 的 MCP 服务器。见用你自己的应用登录。
写入、删除和发送(高级)AI 是否先询问(见下文)。
警告

请把密钥填在密钥中,绝不要放在地址里(…?key=…)。使用团队连接的人能看到它的地址,AI 也会读取地址。

#更改需要同意

读取会立即执行。其他操作都算写入,按照连接的写入、删除和发送设置处理:

设置会怎样
每次都询问(默认)Trina AX 会显示一张卡片,列出要发送的所有内容。在有人同意之前,什么都不会发出。
禁止写入只能查询;写入会被拒绝。
无需询问直接运行写入会直接执行,不再询问。只有管理员可以选择,而且只用于团队连接。

管理连接的人还可以在它的页面上单独关闭某些工具。应用返回的内容会被当作外部数据,绝不会被当作指令。在定时任务中没有人可以同意, 所以写入会被拒绝,除非是任务卡片上允许的、设为无需询问直接运行的团队连接。

#模板:每位成员使用自己的密钥

很多应用会让密钥拥有其主人的权限,并把每次调用都记在那个人名下。对这类应用,管理员可以添加一个模板:应用只登记一次, 每位成员用自己的密钥或登录来连接。

  1. 添加模板

    在管理 › 已连接的应用中,选择通过地址添加(或者在应用的页面上,选择为团队连接旁边的箭头 › 作为模板:每位成员各自连接)。 在高级下,把由谁连接设为每位成员各自。填写地址、登录方式以及适用于谁。这里没有密钥输入框,地址中也不能有 ?… 部分:放在那里的密钥会到达每位成员。用 给成员的说明(可选) 告诉大家去哪里获取密钥。

    模板
  2. 成员连接

    适用的成员会在动态中收到通知,并在设置 › 连接器的你的连接器下看到它,带有团队标签和连接按钮。他们输入自己的密钥 或登录。它会成为他们自己的连接,只在他们自己的对话中使用。

团队连接(一个密钥)模板
密钥一个,由管理员添加每位成员自己的
AI 使用谁的权限密钥主人的,对所有人都一样每位成员自己的
管理员能看到什么这个连接谁在什么时候连接了,以及谁的密钥失效了;永远看不到密钥

在“管理 › 已连接的应用”中模板的那一行,模板 · N人已连接会打开适用的人员列表:已连接、未连接或密钥已失效。需要模板的 定时任务在没有你自己的密钥时不会运行:结果会说明需要你自己的……密钥,并链接到连接。

成员只能更改自己的密钥或登录,以及写入设置,并且可以随时断开。如果管理员更改了模板的地址或登录方式,所有成员的密钥都会被删除,需要重新连接; 改名称或说明则不影响大家的连接。删除模板,或把某人从模板中移除,会删除他们的连接。

#请成员连接

管理员还可以给某位成员发送一个已填好应用的请求:管理 › 已连接的应用 › 添加旁边的箭头 › 请成员连接。成员会收到通知, 用自己的密钥连接,或拒绝。管理员永远看不到密钥。

#在对话中连接

你也可以在对话中说:“连接 Linear。”AI 会填好应用的官方地址并显示一张卡片。你只需在卡片中登录或粘贴密钥。密钥永远不会到达 AI。

#常见问题

你看到的该怎么做
需要登录登录已结束,或密钥在应用那边被撤销。打开连接并选择重新登录或更换密钥。
登录尚未完成。登录窗口被关闭了,或被其他窗口挡住了。选择打开登录窗口,或取消后重试。
在该服务中未获允许访问。你在应用的页面上选择了 Cancel 或 Deny。请重新登录并允许。
无法检查连接。,原因中有“401”或“unauthorized”密钥错误、已过期,或复制时带了空格。请用应用的复制按钮重新复制。如果用的不是 Bearer 请求头,请逐个字母检查请求头名称。
该服务没有列出任何工具。这个地址不是 MCP 地址(常常是粘贴了应用的首页)。请使用应用 MCP 帮助页面中的地址。
成员找不到某个应用成员只能从发现连接应用。请管理员通过地址添加它,或作为模板添加。

#反方向

你自己的 Claude(Claude Code、Claude Desktop 或 claude.ai)可以连接到 Trina AX,并以你的权限使用你的文件。 了解 Team AX MCP 连接器(英文)。

面向开发者的完整说明:集成(英文)。

Trina AX 是采用 AGPL-3.0-only 许可的自由软件。图标:Lucide(ISC)。 编辑此页