# 连接 MCP 服务器（含 OAuth 授权）｜Creght

> 在 Creght 的 Func 里用 ctx.mcp 调 Linear、Notion、Sentry 等 MCP 服务器：平台处理 OAuth 授权和 token 刷新，支持站长账号和访客各自账号两种模式。

[![Creght](https://ugc.talizen.com/_assets/site/2061660904709165056/1780797461299__creght_logo.png)API for AI](/)

[查看 llms.txt](/llms.txt)

概览

- [Creght AI 编程指南](/api.md)
- [通过 MCP 连接 Creght](/api/mcp-server.md)

AI 可发现性

- [如何优化 llms.txt](/api/optimize-llms-txt.md)

站点配置

- [配置 talizen.config.ts](/api/talizen-config.md)
- [实现基于域名的多语言路由](/api/domain-locale-routing.md)

后端

- [在服务端调用外部 API 并管理缓存](/api/ssr-external-api-cache.md)
- [使用 Func 构建站点后端能力](/api/func-backend.md)
- [JSON 表：定义、读写与查询](/api/func-json-tables.md)
- [上传文件：直传与 Func 内生成](/api/func-assets-upload.md)
- [超时配置与流式响应](/api/func-timeout-streaming.md)
- [使用 Func 接入支付宝电脑网站支付](/api/func-alipay-payment.md)
- [表单提交 webhook：实时推送与验签](/api/form-webhook.md)

集成

- [使用集成发送邮件与验证码](/api/func-email-integration.md)
- [使用集成接入支付宝支付](/api/func-alipay-integration.md)
- [使用集成接入 Stripe 支付](/api/func-stripe-integration.md)
- [使用集成调用 OpenAI 模型](/api/func-ai-integration.md)
- [连接 MCP 服务器（含 OAuth 授权）](/api/func-mcp-integration.md)
- [使用集成接入文字转语音](/api/func-tts-integration.md)

登录与用户

- [注册时验证邮箱](/api/auth-verified-registration.md)
- [实现找回密码与修改密码](/api/auth-password-reset.md)
- [在 Func 里实现登录](/api/auth-func-login.md)
- [在 Func 里查询用户](/api/func-user-directory.md)

本页目录

- [添加 MCP 服务器](#connect)
- [在 Func 里调用](#call)
- [每个访客连接自己的账号](#visitor)
- [安全与限制](#security)

概览

- [Creght AI 编程指南](/api.md)
- [通过 MCP 连接 Creght](/api/mcp-server.md)

AI 可发现性

- [如何优化 llms.txt](/api/optimize-llms-txt.md)

站点配置

- [配置 talizen.config.ts](/api/talizen-config.md)
- [实现基于域名的多语言路由](/api/domain-locale-routing.md)

后端

- [在服务端调用外部 API 并管理缓存](/api/ssr-external-api-cache.md)
- [使用 Func 构建站点后端能力](/api/func-backend.md)
- [JSON 表：定义、读写与查询](/api/func-json-tables.md)
- [上传文件：直传与 Func 内生成](/api/func-assets-upload.md)
- [超时配置与流式响应](/api/func-timeout-streaming.md)
- [使用 Func 接入支付宝电脑网站支付](/api/func-alipay-payment.md)
- [表单提交 webhook：实时推送与验签](/api/form-webhook.md)

集成

- [使用集成发送邮件与验证码](/api/func-email-integration.md)
- [使用集成接入支付宝支付](/api/func-alipay-integration.md)
- [使用集成接入 Stripe 支付](/api/func-stripe-integration.md)
- [使用集成调用 OpenAI 模型](/api/func-ai-integration.md)
- [连接 MCP 服务器（含 OAuth 授权）](/api/func-mcp-integration.md)
- [使用集成接入文字转语音](/api/func-tts-integration.md)

登录与用户

- [注册时验证邮箱](/api/auth-verified-registration.md)
- [实现找回密码与修改密码](/api/auth-password-reset.md)
- [在 Func 里实现登录](/api/auth-func-login.md)
- [在 Func 里查询用户](/api/func-user-directory.md)

集成/连接 MCP 服务器（含 OAuth 授权）

# 连接 MCP 服务器（含 OAuth 授权）

在集成里加一个 MCP 服务器，Func 里用 ctx.mcp 调它的工具。支持需要 OAuth 登录的服务器，可以用站长的账号，也可以让每个访客连接自己的账号。token 由平台保管，不进 Func。

复制 Markdown 链接

在集成里加一个 MCP 服务器之后，Func 里用 `ctx.mcp('名称', 工具, 参数)` 就能调它的工具，包括需要登录授权（OAuth）的服务器，比如 Linear、Notion、Sentry。授权流程和 token 都由平台处理，代码里拿不到 token。

**两种授权身份**

**站长的账号**：在编辑器里授权一次，所有访客的调用都用这个账号，适合把你自己的工具接到网站上。

**每个访客自己的账号**：访客先登录网站，再连接自己的账号，适合做「在网站上管理你自己的 Linear 任务」这类功能。

## 添加 MCP 服务器

打开编辑器的 **后端 → 集成**，点 **MCP**，按下表填写。保存时平台会真的连一次服务器，地址或认证方式不对当场报错。

| 字段 | 填什么 | 必填 |
| --- | --- | --- |
| 名称 | 代码里的服务器名，比如 `linear`。只能用字母、数字、 `-` 和 `_`，不能叫 `creght` | 是 |
| 服务器地址 | MCP 的 Streamable HTTP 地址，一般以 `/mcp` 结尾，比如 `https://mcp.linear.app/mcp`。只支持 https | 是 |
| 认证方式 | **OAuth**：需要登录授权的服务器（默认）。 **Token**：服务器给了一个固定 token。 **无**：公开服务器 | 是 |
| 用谁的账号 | OAuth 时选择： **我的**，或 **每个访客连接自己的** | OAuth 时 |
| Scope | 留空则按服务器的要求申请 | 否 |
| OAuth 客户端 ID / 密钥 | 只有服务器不支持自动注册客户端时才需要。大多数服务器（Linear、Notion、Sentry、Atlassian）都支持，不用填 | 否 |

选「我的」时，保存后在卡片上点 **授权**，弹窗里登录并同意即可。卡片上可以看到授权状态和服务器提供的全部工具。

## 在 Func 里调用

```ts
export async function createTask(input, ctx) {
  const tools = await ctx.mcp.tools('linear')          // [{ name, description, input_schema }]
  const issue = await ctx.mcp('linear', 'create_issue', {
    title: input.title,
    team: 'ENG',
  })
  return issue
}
```

| 方法 | 说明 |
| --- | --- |
| `ctx.mcp(name, tool, args?)` | 调一个工具。返回工具的结构化结果；工具只返回文本时，是 JSON 就解析，不是就原样返回。工具报错会抛异常 |
| `ctx.mcp.tools(name)` | 列出工具： `name`、 `description`、 `input_schema`。写代码前先看一次，工具名和参数以它为准 |
| `ctx.mcp.status(name)` | 当前能不能调： `connected`、 `connect_as`、 `signed_in`、 `authorize_url` |
| `ctx.mcp.disconnect(name)` | 删除当前访客自己的授权。只对「每个访客连接自己的」生效 |

**没有授权时**

调用会抛出 `code` 为 `mcp_authorization_required` 的异常。站长账号模式下，去集成里重新授权即可；访客模式下，把访客送去 `authorize_url`，见下一节。

## 每个访客连接自己的账号

平台不提供访客端的界面，按钮和提示由网站自己的页面来做。平台提供的是一个授权入口：

```
/auth/mcp/start?server=linear&redirect=/dashboard
```

访客必须已经登录网站。打开这个地址后，平台带访客去服务器那边登录并同意，完成后跳回 `redirect` 指定的站内页面，地址上带 `?mcp_connected=linear`；失败时带 `?mcp_error=原因`。以后这个访客的调用会自动用他自己的账号。

推荐把「需要连接」当作正常的返回值，而不是让页面去处理异常：

```ts
import type { TalizenFuncContext } from 'talizen/func-runtime'

export async function myIssues(input: unknown, ctx: TalizenFuncContext) {
  ctx.auth.requireUser()
  const st = await ctx.mcp.status('linear')
  if (!st.connected) return { needConnect: true, url: st.authorize_url }
  try {
    const issues = await ctx.mcp('linear', 'list_issues', { assignee: 'me' })
    return { needConnect: false, issues }
  } catch (e: any) {
    if (e.code === 'mcp_authorization_required') {
      return { needConnect: true, url: st.authorize_url }
    }
    throw e
  }
}

export async function disconnect(input: unknown, ctx: TalizenFuncContext) {
  ctx.auth.requireUser()
  return ctx.mcp.disconnect('linear')
}
```

页面里：

```tsx
import { invoke } from 'talizen/func'

const res = await invoke('linear.myIssues', {})
if (res.needConnect) {
  const href = res.url + '&redirect=' + encodeURIComponent(location.pathname)
  // render <a href={href}>Connect Linear</a>
}
```

访客身份优先使用网站的登录用户（ `ctx.auth`），没有时使用项目成员登录（ `ctx.member`）。所以在编辑器里试跑 Func 时，用的是你在集成卡片上点「连接我的账号」授权的那一份。

## 安全与限制

- token 只保存在平台，加密存储，不会进入 Func。快过期时平台会自动刷新；刷新也失败时，调用返回 `mcp_authorization_required`。
- 不要在 Func 里自己实现 MCP 的授权，也不要用 `fetch` 直接调 MCP 服务器。只有选了 Token 认证时，才可以打开「暴露给 Func」用环境变量自己调。
- 只支持 Streamable HTTP，不支持旧的 HTTP + SSE 传输和本机的 stdio 服务器。
- 每次调用会新建一次连接，比调普通接口多一次往返，不适合在一个请求里调几十次。
- 修改服务器地址、认证方式、授权身份或客户端 ID 后，已有的授权全部失效，需要重新授权。

本页目录

- [添加 MCP 服务器](#connect)
- [在 Func 里调用](#call)
- [每个访客连接自己的账号](#visitor)
- [安全与限制](#security)

![Creght](https://ugc.talizen.com/_assets/site/2061660904709165056/1780797461299__creght_logo.png)

此网站使用 [Creght](/) 创建

![微信客服](https://fsu.creght.com/site/2066727200882692096/1785119134612__image.png?w=3072&fmt=webp)

微信客服

## 链接

- [SaaS 官网生成器](/saas-website-builder.md)
- [价格](/price.md)
- [解决方案](/solution.md)
- [交付与独立部署](/delivery.md)
- [桌面版下载](/desktop.md)
- [客户案例](/customers.md)
- [AI 模型对比](/ai-models.md)
- [帮助中心](/help.md)
- [联系我们](/contact.md)
- [更新记录 & 博客](/blogs.md)
- [退款说明](/tuikuan.md)

## 资源

- [全部资源](/resources.md)
- [模板](/templates.md)
- [组件库](https://blocks.creght.com/)
- [动效库](/design/effects.md)
- [Figma to Creght](/figma2creght.md)
- [API](/api.md)

## 产品对比

- [对比上线了](/creght-vs-sxl.md)
- [对比凡科建站](/creght-vs-fkw.md)
- [Creght vs 自己写代码](/compare/self-coding.md)
- [Creght vs 外包](/compare/outsourcing.md)
- [Creght vs Framer](/compare/framer.md)
- [Creght vs WordPress](/compare/wordpress.md)

## 协议

- [用户协议](/legal/terms.md)
- [隐私政策](/legal/privacy.md)
- [可接受使用政策](/legal/acceptable-use.md)

## 社交媒体

- [小红书](https://www.xiaohongshu.com/user/profile/5a38606811be10715f4895b6)
- [哔哩哔哩](https://space.bilibili.com/513308095)

[蜀ICP备2023038192号-2](https://beian.miit.gov.cn)

免费方案评估

> 全站页面清单：[/llms.txt](/llms.txt)
