Unified Context Layer

Fastn MCP 服务

通过一个多租户 MCP 端点，为你的 AI Agent 和应用安全、受治理地开放客户的工具和系统。

Fastn MCP 服务是 Fastn 的一部分。Fastn 是面向 SaaS 产品和 AI Agent 的嵌入式集成平台。Fastn MCP 服务是一个可用于生产环境的 Model Context Protocol (MCP) 网关，可将 AI Agent 和应用连接到 Slack、Jira、GitHub、Salesforce、HubSpot、Postgres 以及另外 200 多种服务，并提供完全托管的身份验证、受治理的多租户访问和亚秒级执行。

该服务基于 Fastn SDK 构建，可开放 MCP 工具，供任何兼容的 AI 平台开箱即用。

为什么选择 Fastn MCP 服务？

功能	描述
250 多种连接器	Slack、Jira、GitHub、Salesforce、HubSpot、Postgres、Stripe、Notion、Linear 等
原生支持 MCP	适用于 Claude Desktop、Cursor、Lovable、Bolt、v0 以及任何兼容 MCP 的客户端
完全托管的身份验证	每个连接器均支持 OAuth 2.1，无需管理令牌、注册应用或处理令牌刷新
受治理的访问	基于角色的权限、审计跟踪和企业合规控制
通过 SOC 2 认证	平台内置企业级安全与合规能力
亚秒级执行	通过 Fastn 平台直接调用 API，并内置缓存和连接池
多种传输方式	stdio（本地）、SSE 和 Streamable HTTP，适用于任何部署模式
可用于生产环境	支持 Docker、运行状况检查、结构化日志记录，以及受 OAuth 2.1 保护的资源元数据
流程自动化	创建、管理和执行由工具组合而成的多步骤工作流

快速开始

1. 在 app.fastn.ai 注册

创建账户并连接你的第一个连接器（Gmail、Slack、GitHub 等）。

2. 连接你的 MCP 客户端

托管服务（推荐），无需安装：

https://mcp.live.fastn.ai/shttp

将任何 MCP 客户端指向此 URL。系统会通过 MCP OAuth 2.1 自动处理身份验证。请参阅客户端配置，了解 Claude Desktop 和 Cursor 的示例。

可自托管，安装并运行你自己的实例：

pip install fastn-mcp-server
fastn-mcp --shttp --port 8000

连接到 MCP 服务

端点

使用托管服务（mcp.live.fastn.ai）或你自托管的实例。每个路径开放不同的工具集：

端点	工具
/shttp	全部 11 个工具：find_tools、execute_tool、list_connectors、list_skills、list_projects、list_flows、run_flow、delete_flow、create_flow、update_flow、configure_custom_auth
/shttp/tools	5 个工具：find_tools、execute_tool、list_connectors、list_skills、list_projects
/shttp/tools/{project_id}	4 个工具：find_tools、execute_tool、list_connectors、list_skills
/shttp/tools/{project_id}/{skill_id}	3 个工具：find_tools、execute_tool、list_connectors
/sse、/sse/tools 等	SSE 传输方式也遵循相同模式

托管服务示例：

https://mcp.live.fastn.ai/shttp                              # All tools
https://mcp.live.fastn.ai/shttp/tools                           # Fastn tools only
https://mcp.live.fastn.ai/shttp/tools/{project_id}              # Pre-set project
https://mcp.live.fastn.ai/shttp/tools/{project_id}/{skill_id}   # Pre-set project + skill

身份验证

MCP 服务支持三种身份验证方式。请从 app.fastn.ai 获取凭据。

MCP OAuth 2.1（推荐）

使用 PKCE 的标准 MCP OAuth 流程。服务会自动桥接到 Fastn 的身份提供方。只需将客户端指向该 URL，系统就会提示你进行身份验证：

{
  "mcpServers": {
    "tools": {
      "url": "https://mcp.live.fastn.ai/shttp"
    }
  }
}

令牌 / API 密钥

在 MCP 客户端配置中，通过 Authorization 标头传入 Fastn 身份验证令牌或 API 密钥：

{
  "mcpServers": {
    "tools": {
      "url": "https://mcp.live.fastn.ai/shttp",
      "headers": {
        "Authorization": "Bearer <your-token-or-api-key>"
      }
    }
  }
}

你也可以传入 x-project-id，将请求限定到特定项目：

{
  "mcpServers": {
    "tools": {
      "url": "https://mcp.live.fastn.ai/shttp",
      "headers": {
        "Authorization": "Bearer <your-token-or-api-key>",
        "x-project-id": "<your-project-id>"
      }
    }
  }
}

对于本地 stdio 传输方式，请通过环境变量传入凭据：

{
  "mcpServers": {
    "tools": {
      "command": "fastn-mcp",
      "args": ["--stdio"],
      "env": {
        "FASTN_API_KEY": "your-api-key",
        "FASTN_PROJECT_ID": "your-project-id"
      }
    }
  }
}

MCP 工具

该服务向 AI Agent 开放以下工具：

Fastn 工具

工具	描述
find_tools	通过自然语言提示词搜索可用的连接器工具。返回匹配工具的 ID 和输入架构。
execute_tool	使用参数按 ID 执行连接器工具。直接返回结果。
list_connectors	浏览注册表中所有 250 多个可用连接器，包括尚未连接的连接器。
list_skills	列出项目中可用的技能。
list_projects	列出已认证用户可用的项目。

工作流： 浏览连接器 → list_connectors。执行操作 → find_tools → execute_tool。如果 find_tools 没有返回相关结果 → list_connectors（可能需要连接该连接器）。

流管理

工具	描述
list_flows	列出项目中保存的自动化流程（流）。
run_flow	按 ID 执行已保存的流。
delete_flow	从项目中移除一个流。
create_flow	（开发中） 根据自然语言创建流。
update_flow	（开发中） 更新现有流。

配置

工具	描述
configure_custom_auth	注册自定义 JWT 身份验证提供方（Auth0、Firebase、Supabase）。

架构

AI Agent (Claude, Cursor, Lovable)
    │
    ▼
MCP Protocol (stdio / SSE / Streamable HTTP)
    │
    ▼
┌─────────────────────────────┐
│   Fastn MCP Server          │
│   ┌───────────────────────┐ │
│   │ Tool Discovery        │ │  find_tools, list_connectors
│   │ Tool Execution        │ │  execute_tool
│   │ Flow Management       │ │  list/run/delete/create flows
│   │ Auth & Config         │ │  OAuth 2.1, custom JWT
│   └───────────────────────┘ │
└─────────────────────────────┘
    │
    ▼
Fastn SDK → Fastn API
    │
    ▼
250+ Connectors (Slack, Jira, GitHub, Salesforce, Postgres, ...)

连接器提供工具。流组合工具。Agent通过推理运行流和工具。

客户端配置

上述 JSON 示例适用于任何 MCP 客户端。以下是配置文件的位置：

客户端	配置文件
Claude Desktop	claude_desktop_config.json
Cursor	项目中的 .cursor/mcp.json
Claude Code	项目中的 .mcp.json

对于 Cursor，使用 /shttp/tools 端点仅公开 Fastn 工具（推荐用于编码助手）：

{
  "mcpServers": {
    "tools": {
      "url": "https://mcp.live.fastn.ai/shttp/tools"
    }
  }
}

自托管

传输模式

stdio（本地），适用于基于管道的客户端：

fastn-mcp --stdio
fastn-mcp --stdio --mode tools                          # Fastn tools only
fastn-mcp --stdio --mode tools --project ID              # Fastn tools + pre-set project
fastn-mcp --stdio --mode tools --project ID --skill ID   # Fastn tools + pre-set project and skill

SSE + Streamable HTTP（远程），适用于基于 Web 的 AI 平台：

fastn-mcp --sse --shttp --port 8000

OAuth 设置

默认情况下，远程传输使用 MCP OAuth 2.1。服务实现了 RFC 9728 受保护资源元数据：

fastn-mcp --sse --shttp --port 8000
# OAuth endpoints auto-configured at /.well-known/oauth-protected-resource

设置 OAuth 元数据的公开 URL：

fastn-mcp --sse --shttp --port 8000 --server-url https://mcp.example.com

在本地开发中禁用 OAuth：

fastn-mcp --sse --port 8000 --no-auth

Docker

docker build -t fastn-mcp .
docker run -p 8000:8000 fastn-mcp

docker compose up -d

环境变量

可自托管部署的服务配置：

FASTN_MCP_PORT=8000
FASTN_MCP_HOST=0.0.0.0
FASTN_MCP_SERVER_URL=https://your-public-url
FASTN_MCP_TRANSPORT=both
FASTN_MCP_NO_AUTH=false
FASTN_MCP_VERBOSE=false

变量	必需	描述
FASTN_MCP_PORT	否	服务端口（默认值：8000）
FASTN_MCP_HOST	否	绑定地址（默认值：0.0.0.0）
FASTN_MCP_SERVER_URL	否	OAuth 元数据的公开 URL
FASTN_MCP_NO_AUTH	否	设置为 true 以禁用 OAuth（仅限开发环境）
FASTN_MCP_TRANSPORT	否	传输模式：sse、shttp、both（默认值：both）
FASTN_MCP_VERBOSE	否	设置为 true 以启用调试日志

使用 ngrok 进行本地开发

仅用于本地开发和测试，使用 ngrok 暴露本地服务：

# Terminal 1: Start the MCP server
fastn-mcp --shttp --port 8000 --verbose

# Terminal 2: Start ngrok tunnel
ngrok http 8000

然后使用 ngrok URL 重启，以解析 OAuth 元数据：

fastn-mcp --shttp --port 8000 \
  --server-url https://abc123.ngrok-free.dev \
  --verbose

在生产环境中，使用 Docker 部署，并通过反向代理和真实域名提供服务。

开发

设置

git clone https://github.com/fastn-ai/fastn-mcp.git
cd fastn-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

运行测试

pytest tests/ -q

项目结构

fastn-mcp/
├── fastn_mcp/
│   ├── __init__.py          # Package metadata
│   ├── __main__.py          # CLI entry point
│   ├── server.py            # MCP server, tools, handlers, routing
│   ├── auth.py              # OAuth 2.1 provider (RFC 9728)
│   └── tools/               # Tool utilities
├── tests/
│   ├── test_server.py       # 185+ tests covering all tools and transports
│   └── conftest.py          # Test fixtures
├── Dockerfile               # Production container
├── docker-compose.yml       # Docker Compose for deployment
├── pyproject.toml           # Python project configuration
└── README.md

CLI 参考

fastn-mcp [OPTIONS]

Transport:
  --stdio          Use stdio transport (Claude Desktop, Cursor)
  --sse            Enable SSE transport
  --shttp          Enable Streamable HTTP transport

Server:
  --host HOST      Bind address (default: 0.0.0.0)
  --port PORT      Port number (default: 8000)
  --no-auth        Disable OAuth (development only)
  --server-url URL Public URL for OAuth metadata

Mode:
  --mode {agent,tools} Tool mode for stdio: "agent" (all tools) or "tools" (Fastn tools only)
  --project ID     Pre-set project ID for stdio
  --skill ID       Pre-set skill ID for stdio (requires --project)

Debug:
  -v, --verbose    Enable debug logging

支持的连接器

Fastn 提供 250 多个预构建连接器，包括：

通信： Slack、Microsoft Teams、Discord、Gmail、Outlook、SendGrid、Twilio

项目管理： Jira、Linear、Asana、Trello、Monday.com、ClickUp、Notion

开发： GitHub、GitLab、Bitbucket、PagerDuty、Sentry、Datadog

CRM 和销售： Salesforce、HubSpot、Pipedrive、Zoho CRM

数据库： PostgreSQL、MySQL、MongoDB、Redis、Supabase、Firebase

云服务： AWS、Google Cloud、Azure、Cloudflare

财务： Stripe、QuickBooks、Xero

以及其他 200 多个连接器，请在 fastn.ai/integrations 浏览完整目录。

许可证

MIT

Links

• Fastn Platform
• Fastn SDK
• MCP Specification
• Documentation