Fastn Server

Uma plataforma escalável para registro e execução dinâmica de ferramentas com base em definições de API, com integrações para serviços como Claude.ai e Cursor.ai.

GitHub

Experimente este MCPPatrocinado

Documentação

Fastn MCP Server

Dê aos seus agentes de IA e aplicativos acesso seguro e governado às ferramentas e sistemas dos seus clientes por meio de um único endpoint MCP multi-tenant.

Parte do Fastn, a plataforma de integração incorporada para produtos SaaS e agentes de IA. O Fastn MCP Server é um gateway Model Context Protocol (MCP) pronto para produção que conecta agentes de IA e aplicativos a Slack, Jira, GitHub, Salesforce, HubSpot, Postgres e mais de 200 outros serviços, com autenticação totalmente gerenciada, acesso multi-tenant governado e execução em menos de um segundo.

Construído no Fastn SDK, este servidor expõe ferramentas MCP que qualquer plataforma de IA compatível pode usar imediatamente.

Por que o Fastn MCP Server?

Recurso	Descrição
250+ Conectores	Slack, Jira, GitHub, Salesforce, HubSpot, Postgres, Stripe, Notion, Linear e mais
MCP Nativo	Funciona com Claude Desktop, Cursor, Lovable, Bolt, v0 e qualquer cliente compatível com MCP
Autenticação Totalmente Gerenciada	OAuth 2.1 para cada conector, sem gerenciamento de tokens, sem registro de aplicativos, sem tratamento de refresh
Acesso Governado	Permissões baseadas em funções, trilhas de auditoria e controles de conformidade empresarial
Certificado SOC 2	Segurança e conformidade de nível empresarial incorporadas à plataforma
Execução em Menos de Um Segundo	Chamadas de API diretas por meio da plataforma Fastn com cache integrado e pooling de conexões
Múltiplos Transportes	stdio (local), SSE e HTTP Streamable para qualquer modelo de implantação
Pronto para Produção	Suporte a Docker, verificações de integridade, registro estruturado e metadados de recursos protegidos por OAuth 2.1
Automação de Fluxos	Crie, gerencie e execute fluxos de trabalho de várias etapas que compõem ferramentas

Início Rápido

1. Cadastre-se em app.fastn.ai

Crie uma conta e conecte seus primeiros conectores (Gmail, Slack, GitHub, etc.).

2. Conecte seu cliente MCP

Servidor hospedado (recomendado), sem necessidade de instalação:

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

Aponte qualquer cliente MCP para esta URL. A autenticação é tratada automaticamente via MCP OAuth 2.1. Consulte Configuração do Cliente para exemplos com Claude Desktop e Cursor.

Auto-hospedado, instale e execute sua própria instância:

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

Conectando ao Servidor MCP

Endpoints

Use o servidor hospedado (mcp.live.fastn.ai) ou sua instância auto-hospedada. Cada caminho expõe um conjunto diferente de ferramentas:

Endpoint	Ferramentas
`/shttp`	Todas as 11 ferramentas: `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 ferramentas: `find_tools`, `execute_tool`, `list_connectors`, `list_skills`, `list_projects`
`/shttp/tools/{project_id}`	4 ferramentas: `find_tools`, `execute_tool`, `list_connectors`, `list_skills`
`/shttp/tools/{project_id}/{skill_id}`	3 ferramentas: `find_tools`, `execute_tool`, `list_connectors`
`/sse`, `/sse/tools`, etc.	Mesmo padrão para transporte SSE

Exemplos com o servidor hospedado:

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

Autenticação

O servidor MCP suporta três métodos de autenticação. Obtenha suas credenciais em app.fastn.ai.

MCP OAuth 2.1 (Recomendado)

Fluxo OAuth MCP padrão com PKCE. O servidor faz a ponte automaticamente com o provedor de identidade do Fastn. Basta apontar seu cliente para a URL; você será solicitado a autenticar:

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

Token / Chave de API

Passe um token de autenticação Fastn ou chave de API por meio do cabeçalho Authorization na configuração do seu cliente MCP:

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

Você também pode passar x-project-id para limitar as solicitações a um projeto específico:

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

Para transporte stdio local, passe as credenciais como variáveis de ambiente:

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

Ferramentas MCP

O servidor expõe estas ferramentas aos agentes de IA:

Ferramentas Fastn

Ferramenta	Descrição
`find_tools`	Pesquise ferramentas de conector disponíveis por prompt em linguagem natural. Retorna ferramentas correspondentes com IDs e esquemas de entrada.
`execute_tool`	Execute uma ferramenta de conector pelo seu ID com parâmetros. Retorna o resultado diretamente.
`list_connectors`	Navegue por todos os 250+ conectores disponíveis no registro, incluindo aqueles ainda não conectados.
`list_skills`	Liste as habilidades disponíveis no projeto.
`list_projects`	Liste os projetos disponíveis para o usuário autenticado.

Fluxo de trabalho: Navegue pelos conectores → list_connectors. Execute uma ação → find_tools → execute_tool. Se find_tools não retornar nada relevante → list_connectors (o conector pode precisar ser conectado).

Gerenciamento de Fluxos

Ferramenta	Descrição
`list_flows`	Liste as automações salvas (fluxos) no projeto.
`run_flow`	Execute um fluxo salvo pelo seu ID.
`delete_flow`	Remova um fluxo do projeto.
`create_flow`	(Em desenvolvimento) Crie um fluxo a partir de linguagem natural.
`update_flow`	(Em desenvolvimento) Atualize um fluxo existente.

Configuração

Ferramenta	Descrição
`configure_custom_auth`	Registre um provedor de autenticação JWT personalizado (Auth0, Firebase, Supabase).

Arquitetura

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

Conectores fornecem ferramentas. Fluxos compõem ferramentas. Agentes executam fluxos e ferramentas com raciocínio.

Configuração do Cliente

Os exemplos JSON acima funcionam com qualquer cliente MCP. Aqui estão os locais dos arquivos de configuração:

Cliente	Arquivo de Configuração
Claude Desktop	`claude_desktop_config.json`
Cursor	`.cursor/mcp.json` no seu projeto
Claude Code	`.mcp.json` no seu projeto

Para Cursor, use o endpoint /shttp/tools para expor apenas as ferramentas Fastn (recomendado para assistentes de codificação):

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

Auto-Hospedagem

Modos de Transporte

stdio (local), Para clientes baseados em pipe:

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 Streamable (remoto), Para plataformas de IA baseadas na web:

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

Configuração OAuth

Transportes remotos usam MCP OAuth 2.1 por padrão. O servidor implementa Metadados de Recursos Protegidos RFC 9728:

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

Defina a URL pública para metadados OAuth:

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

Para desabilitar OAuth no desenvolvimento local:

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

Docker

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

docker compose up -d

Variáveis de Ambiente

Configuração do servidor para implantações auto-hospedadas:

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

Variável	Obrigatória	Descrição
`FASTN_MCP_PORT`	Não	Porta do servidor (padrão: `8000`)
`FASTN_MCP_HOST`	Não	Endereço de bind (padrão: `0.0.0.0`)
`FASTN_MCP_SERVER_URL`	Não	URL pública para metadados OAuth
`FASTN_MCP_NO_AUTH`	Não	Defina como `true` para desabilitar OAuth (apenas desenvolvimento)
`FASTN_MCP_TRANSPORT`	Não	Modo de transporte: `sse`, `shttp`, `both` (padrão: `both`)
`FASTN_MCP_VERBOSE`	Não	Defina como `true` para registro de depuração

Desenvolvimento Local com ngrok

Para desenvolvimento e teste local apenas, use ngrok para expor seu servidor local:

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

# Terminal 2: Start ngrok tunnel
ngrok http 8000

Em seguida, reinicie com a URL do ngrok para que os metadados OAuth sejam resolvidos:

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

Para produção, implante com Docker atrás de um proxy reverso com um domínio real.

Desenvolvimento

Configuração

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

Executar Testes

pytest tests/ -q

Estrutura do Projeto

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

Referência da 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

Conectores Suportados

O Fastn fornece 250+ conectores pré-construídos, incluindo:

Comunicação: Slack, Microsoft Teams, Discord, Gmail, Outlook, SendGrid, Twilio

Gerenciamento de Projetos: Jira, Linear, Asana, Trello, Monday.com, ClickUp, Notion

Desenvolvimento: GitHub, GitLab, Bitbucket, PagerDuty, Sentry, Datadog

CRM e Vendas: Salesforce, HubSpot, Pipedrive, Zoho CRM

Bancos de Dados: PostgreSQL, MySQL, MongoDB, Redis, Supabase, Firebase

Nuvem: AWS, Google Cloud, Azure, Cloudflare

Finanças: Stripe, QuickBooks, Xero

E mais de 200 outros, navegue pelo catálogo completo em fastn.ai/integrations

Licença

MIT

Fastn Server

Documentação

Fastn MCP Server

Por que o Fastn MCP Server?

Início Rápido

1. Cadastre-se em app.fastn.ai

2. Conecte seu cliente MCP

Conectando ao Servidor MCP

Endpoints

Autenticação

MCP OAuth 2.1 (Recomendado)

Token / Chave de API

Ferramentas MCP

Ferramentas Fastn

Gerenciamento de Fluxos

Configuração

Arquitetura

Configuração do Cliente

Auto-Hospedagem

Modos de Transporte

Configuração OAuth

Docker

Variáveis de Ambiente

Desenvolvimento Local com ngrok

Desenvolvimento

Configuração

Executar Testes

Estrutura do Projeto

Referência da CLI

Conectores Suportados

Licença

Links