Fastn Server

Una plataforma escalable para el registro y ejecución din

Documentación

Fastn MCP Server

Brinda a tus agentes y aplicaciones de IA acceso seguro y gobernado a las herramientas y sistemas de tus clientes a través de un único endpoint MCP multi-tenant.

Parte de Fastn, la plataforma de integración embebida para productos SaaS y agentes de IA. Fastn MCP Server es una puerta de enlace de Model Context Protocol (MCP) lista para producción que conecta agentes y aplicaciones de IA con Slack, Jira, GitHub, Salesforce, HubSpot, Postgres y más de 200 servicios adicionales, con autenticación totalmente gestionada, acceso multi-tenant gobernado y ejecución en menos de un segundo.

Construido sobre el Fastn SDK, este servidor expone herramientas MCP que cualquier plataforma de IA compatible puede usar de inmediato.

¿Por qué Fastn MCP Server?

Característica	Descripción
Más de 250 conectores	Slack, Jira, GitHub, Salesforce, HubSpot, Postgres, Stripe, Notion, Linear y más
MCP nativo	Funciona con Claude Desktop, Cursor, Lovable, Bolt, v0 y cualquier cliente compatible con MCP
Autenticación totalmente gestionada	OAuth 2.1 para cada conector, sin gestión de tokens, sin registro de aplicaciones, sin manejo de renovación
Acceso gobernado	Permisos basados en roles, registros de auditoría y controles de cumplimiento empresarial
Certificado SOC 2	Seguridad y cumplimiento de nivel empresarial integrados en la plataforma
Ejecución en menos de un segundo	Llamadas API directas a través de la plataforma Fastn con caché integrada y agrupación de conexiones
Múltiples transportes	stdio (local), SSE y Streamable HTTP para cualquier modelo de implementación
Listo para producción	Soporte para Docker, comprobaciones de salud, registro estructurado y metadatos de recursos protegidos por OAuth 2.1
Automatización de flujos	Crea, gestiona y ejecuta flujos de trabajo de varios pasos que componen herramientas

Inicio rápido

1. Regístrate en app.fastn.ai

Crea una cuenta y conecta tus primeros conectores (Gmail, Slack, GitHub, etc.).

2. Conecta tu cliente MCP

Servidor alojado (recomendado), sin necesidad de instalación:

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

Apunta cualquier cliente MCP a esta URL. La autenticación se gestiona automáticamente mediante MCP OAuth 2.1. Consulta Configuración del cliente para ver ejemplos de Claude Desktop y Cursor.

Autoalojado, instala y ejecuta tu propia instancia:

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

Conexión al servidor MCP

Endpoints

Usa el servidor alojado (mcp.live.fastn.ai) o tu instancia autoalojada. Cada ruta expone un conjunto diferente de herramientas:

Endpoint	Herramientas
`/shttp`	Las 11 herramientas: `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 herramientas: `find_tools`, `execute_tool`, `list_connectors`, `list_skills`, `list_projects`
`/shttp/tools/{project_id}`	4 herramientas: `find_tools`, `execute_tool`, `list_connectors`, `list_skills`
`/shttp/tools/{project_id}/{skill_id}`	3 herramientas: `find_tools`, `execute_tool`, `list_connectors`
`/sse`, `/sse/tools`, etc.	Mismo patrón para transporte SSE

Ejemplos con el servidor alojado:

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

Autenticación

El servidor MCP admite tres métodos de autenticación. Obtén tus credenciales en app.fastn.ai.

MCP OAuth 2.1 (Recomendado)

Flujo OAuth estándar de MCP con PKCE. El servidor se conecta automáticamente al proveedor de identidad de Fastn. Solo apunta tu cliente a la URL y se te pedirá que te autentiques:

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

Token / Clave API

Pasa un token de autenticación de Fastn o una clave API mediante el encabezado Authorization en la configuración de tu cliente MCP:

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

También puedes pasar x-project-id para limitar las solicitudes a un proyecto 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, pasa las credenciales como variables de entorno:

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

Herramientas MCP

El servidor expone estas herramientas a los agentes de IA:

Herramientas de Fastn

Herramienta	Descripción
`find_tools`	Busca herramientas de conector disponibles mediante un prompt en lenguaje natural. Devuelve las herramientas coincidentes con sus IDs y esquemas de entrada.
`execute_tool`	Ejecuta una herramienta de conector por su ID con parámetros. Devuelve el resultado directamente.
`list_connectors`	Explora los más de 250 conectores disponibles en el registro, incluidos los que aún no están conectados.
`list_skills`	Lista las habilidades disponibles en el proyecto.
`list_projects`	Lista los proyectos disponibles para el usuario autenticado.

Flujo de trabajo: Explora conectores → list_connectors. Ejecuta una acción → find_tools → execute_tool. Si find_tools no devuelve nada relevante → list_connectors (es posible que el conector necesite conexión).

Gestión de flujos

Herramienta	Descripción
`list_flows`	Lista las automatizaciones (flujos) guardadas en el proyecto.
`run_flow`	Ejecuta un flujo guardado por su ID.
`delete_flow`	Elimina un flujo del proyecto.
`create_flow`	(En desarrollo) Crea un flujo a partir de lenguaje natural.
`update_flow`	(En desarrollo) Actualiza un flujo existente.

Configuración

Herramienta	Descripción
`configure_custom_auth`	Registra un proveedor de autenticación JWT personalizado (Auth0, Firebase, Supabase).

Arquitectura

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

Los conectores proporcionan herramientas. Los flujos componen herramientas. Los agentes ejecutan flujos y herramientas con razonamiento.

Configuración del cliente

Los ejemplos JSON anteriores funcionan con cualquier cliente MCP. Estas son las ubicaciones de los archivos de configuración:

Cliente	Archivo de configuración
Claude Desktop	`claude_desktop_config.json`
Cursor	`.cursor/mcp.json` en tu proyecto
Claude Code	`.mcp.json` en tu proyecto

Para Cursor, usa el endpoint /shttp/tools para exponer solo las herramientas de Fastn (recomendado para asistentes de codificación):

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

Autoalojamiento

Modos de transporte

stdio (local), para clientes basados en pipes:

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 (remoto), para plataformas de IA basadas en web:

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

Configuración de OAuth

Los transportes remotos usan MCP OAuth 2.1 de forma predeterminada. El servidor implementa los Metadatos de Recursos Protegidos RFC 9728:

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

Establece la URL pública para los metadatos de OAuth:

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

Para deshabilitar OAuth en el desarrollo 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

Variables de entorno

Configuración del servidor para implementaciones autoalojadas:

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

Variable	Obligatoria	Descripción
`FASTN_MCP_PORT`	No	Puerto del servidor (predeterminado: `8000`)
`FASTN_MCP_HOST`	No	Dirección de enlace (predeterminado: `0.0.0.0`)
`FASTN_MCP_SERVER_URL`	No	URL pública para metadatos de OAuth
`FASTN_MCP_NO_AUTH`	No	Establecer en `true` para deshabilitar OAuth (solo desarrollo)
`FASTN_MCP_TRANSPORT`	No	Modo de transporte: `sse`, `shttp`, `both` (predeterminado: `both`)
`FASTN_MCP_VERBOSE`	No	Establecer en `true` para registro de depuración

Desarrollo local con ngrok

Solo para desarrollo y pruebas locales, usa ngrok para exponer tu servidor local:

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

# Terminal 2: Start ngrok tunnel
ngrok http 8000

Luego reinicia con la URL de ngrok para que los metadatos de OAuth se resuelvan:

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

Para producción, implementa con Docker detrás de un proxy inverso con un dominio real.

Desarrollo

Configuración

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

Ejecutar pruebas

pytest tests/ -q

Estructura del proyecto

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

Referencia de 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 compatibles

Fastn proporciona más de 250 conectores preconstruidos, incluidos:

Comunicación: Slack, Microsoft Teams, Discord, Gmail, Outlook, SendGrid, Twilio

Gestión de proyectos: Jira, Linear, Asana, Trello, Monday.com, ClickUp, Notion

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

CRM y ventas: Salesforce, HubSpot, Pipedrive, Zoho CRM

Bases de datos: PostgreSQL, MySQL, MongoDB, Redis, Supabase, Firebase

Nube: AWS, Google Cloud, Azure, Cloudflare

Finanzas: Stripe, QuickBooks, Xero

Y más de 200 adicionales, explora el catálogo completo en fastn.ai/integrations

Licencia

MIT

Fastn Server

Documentación

Fastn MCP Server

¿Por qué Fastn MCP Server?

Inicio rápido

1. Regístrate en app.fastn.ai

2. Conecta tu cliente MCP

Conexión al servidor MCP

Endpoints

Autenticación

MCP OAuth 2.1 (Recomendado)

Token / Clave API

Herramientas MCP

Herramientas de Fastn

Gestión de flujos

Configuración

Arquitectura

Configuración del cliente

Autoalojamiento

Modos de transporte

Configuración de OAuth

Docker

Variables de entorno

Desarrollo local con ngrok

Desarrollo

Configuración

Ejecutar pruebas

Estructura del proyecto

Referencia de CLI

Conectores compatibles

Licencia

Enlaces