Fastn MCP

Fastn MCP服务器

让您的AI代理和应用程序即时、安全地访问250多个企业系统。

Fastn MCP服务器已准备好投入生产 模型上下文协议（MCP） 该网关将人工智能代理和应用程序连接到Slack、Jira、GitHub、Salesforce、HubSpot、Postgres和200多个服务，具有完全托管的身份验证、受控访问和亚秒级执行。

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

为什么选择Fastn MCP服务器？

快速开始

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)或者您的自托管实例。每条路径都暴露了一组不同的工具：

托管服务器示例：

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 "
      }
    }
  }
}

你也可以通过 x-project-id 将请求范围限定到特定项目：

{
  "mcpServers": {
    "tools": {
      "url": "https://mcp.live.fastn.ai/shttp",
      "headers": {
        "Authorization": "Bearer ",
        "x-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工具

工作流程： 浏览连接器→ list_connectors.执行操作→ find_tools → execute_tool.如果 find_tools 不返回任何相关内容→ list_connectors （连接器可能需要连接）。

流量管理

配置

建筑

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客户端。以下是配置文件的位置：

对于光标，使用 /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

与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/fastnai/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/集成

许可证

麻省理工学院

链接

• Fastn平台
• Fastn SDK
• MCP规范
• 文档