多租户MCP网关服务

Fastn MCP Server是一个生产就绪的模型上下文协议(MCP)网关,为AI代理和应用程序提供安全、受管理的多租户访问250+服务的功能,包括Slack、Jira、GitHub等,具备完全托管的身份验证和治理控制。

  • by fastn-ai
  • Python
  • 本地部署
  • 23 星标
  • 更新于
在 GitHub 查看 fastnai/mcp-fastn

使用说明

Fastn MCP服务器

通过一个多租户MCP端点,让您的AI代理和应用程序安全、受控地访问客户的工具和系统。

Fastn是SaaS产品和AI代理的嵌入式集成平台的一部分。Fastn MCP服务器已准备好投入生产 模型上下文协议(MCP) 网关,将人工智能代理和应用程序连接到Slack、Jira、GitHub、Salesforce、HubSpot、Postgres和200多个服务,具有完全托管的身份验证、受控的多租户访问和亚秒级执行。

建立在 Fastn SDK,此服务器公开了任何兼容的AI平台都可以开箱即用的MCP工具。

为什么选择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自动处理。看 客户端配置 克劳德桌面和光标示例。

自托管,安装并运行您自己的实例:

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密钥

通过 Authorization MCP客户端配置中的header:

{
  "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代理:

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, ...)

连接器 提供工具。 流动 组合工具。 代理 使用推理运行流程和工具。

客户端配置

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

客户端 配置文件
克劳德桌面版 claude_desktop_config.json
光标 .cursor/mcp.json 在您的项目中
克劳德代码 .mcp.json 在您的项目中

对于光标,使用 /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+流式HTTP(远程),对于基于网络的人工智能平台:

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 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、微软团队、Discord、Gmail、Outlook、SendGrid、Twilio

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

发展: GitHub、GitLab、Bitbucket、PagerDuty、Sentry、Datadog

客户关系管理和销售: Salesforce、HubSpot、Pipedrive、Zoho CRM

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

云: AWS、谷歌云、Azure、Cloudflare

财务: Stripe、QuickBooks、Xero

200多个,浏览完整目录 fastn.ai/集成

许可证

麻省理工学院

链接