Guías
Conectar por MCP
Floid expone un servidor Model Context Protocol remoto. Cualquier agente compatible puede buscar en el catálogo y ejecutar lecturas con el token Floid de tu empresa.
| Producción | https://mcp.floid.app |
|---|---|
| Sandbox | https://mcp.floid.app/sandbox |
| Transporte | Streamable HTTP, sin sesión |
| Autenticación | Encabezado Authorization: Bearer <token Floid> |
Si abres esa URL en un navegador, llegas a esta documentación; un cliente MCP se conecta al servidor. También responde en https://mcp.floid.app/mcp y https://mcp.floid.app/sandbox/mcp.
Las credenciales nunca pasan por un modelo de IA
Por MCP no se aceptan claves ni certificados: solo credencial_token, que el titular obtiene al conectar su cuenta en el widget de Floid.
Si un agente intenta enviar una clave, la capa la rechaza con CREDENCIAL_NO_PERMITIDA antes de llamar a Floid.
Herramientas del servidor
Son solo dos, para no llenar el contexto del agente. Las 55 lecturas del catálogo se descubren buscando.
| Herramienta | Qué hace |
|---|---|
| buscar_herramientas | Busca por palabras (consulta) y opcionalmente por fuente. Con 5 resultados o menos devuelve la ficha completa de cada una. |
| ejecutar | Ejecuta una lectura: herramienta (nombre exacto) y parametros según la ficha. |
Configura tu cliente
Define primero la variable de entorno FLOID_TOKEN con tu token. Así el token queda en la configuración del cliente y nunca en la conversación.
~/.cursor/mcp.json
{
"mcpServers": {
"floid": {
"url": "https://mcp.floid.app",
"headers": {
"Authorization": "Bearer ${env:FLOID_TOKEN}"
}
}
}
}
Terminal
claude mcp add --transport http floid https://mcp.floid.app \
--header "Authorization: Bearer $FLOID_TOKEN"
.vscode/mcp.json
{
"inputs": [
{
"type": "promptString",
"id": "floid-token",
"description": "Token Floid",
"password": true
}
],
"servers": {
"floid": {
"type": "http",
"url": "https://mcp.floid.app",
"headers": {
"Authorization": "Bearer ${input:floid-token}"
}
}
}
}
claude_desktop_config.json
{
"mcpServers": {
"floid": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.floid.app",
"--header",
"Authorization:${AUTH}"
],
"env": {
"AUTH": "Bearer <token Floid>"
}
}
}
}
Desde tu propio agente
Las APIs de modelos con soporte de MCP remoto se conectan con la URL y el token Floid.
import os
import anthropic
cliente = anthropic.Anthropic()
respuesta = cliente.beta.messages.create(
model="claude-opus-5-5",
max_tokens=2000,
betas=["mcp-client-2026-09-15"],
mcp_servers=[{
"type": "url",
"url": "https://mcp.floid.app",
"name": "floid",
"authorization_token": os.environ["FLOID_TOKEN"],
}],
tools=[{"type": "mcp_toolset", "mcp_server_name": "floid"}],
messages=[{"role": "user", "content": "¿Qué datos tributarios puedo consultar de una empresa?"}],
)
import os
from openai import OpenAI
cliente = OpenAI()
respuesta = cliente.responses.create(
model="gpt-5",
tools=[{
"type": "mcp",
"server_label": "floid",
"server_url": "https://mcp.floid.app",
"headers": {"Authorization": f"Bearer {os.environ['FLOID_TOKEN']}"},
"require_approval": "never",
}],
input="¿Qué datos tributarios puedo consultar de una empresa?",
)
import asyncio
import os
import httpx
from mcp import ClientSession
from mcp.client.streamable_http import streamable_http_client
async def main():
encabezados = {"Authorization": f"Bearer {os.environ['FLOID_TOKEN']}"}
async with httpx.AsyncClient(headers=encabezados, timeout=300) as http:
async with streamable_http_client("https://mcp.floid.app/sandbox", http_client=http) as (leer, escribir, *_):
async with ClientSession(leer, escribir) as sesion:
await sesion.initialize()
resultado = await sesion.call_tool("buscar_herramientas", {"consulta": "movimientos empresa"})
print(resultado.content[0].text)
asyncio.run(main())
claude.ai y ChatGPT en la web solo conectan servidores MCP con OAuth. El acceso con OAuth está en el plan de Floid; mientras tanto, usa los clientes de arriba.
Cómo lo usa un agente
- Llama
buscar_herramientascon palabras del pedido del usuario, por ejemplo"carpeta tributaria". - Lee la ficha: parámetros, bancos y avisos (por ejemplo, que una clave errada puede bloquear la cuenta).
- Llama
ejecutarcon el nombre exacto ycredencial_token. - Si
meta.pagina.has_morees true, pide la siguiente página con el mismocaseid. - Ante un error, sigue
error.sugerencia; sireintentablees false, no reintenta igual.
Límites
- Las herramientas paginables devuelven 50 elementos por página si no se indica
limite. - Las respuestas son JSON compacto para ocupar menos contexto.
- Las lecturas pueden tardar: un login bancario toma alrededor de un minuto. Configura tu cliente con un tiempo de espera amplio.