Floid Developers Contáctanos

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ónhttps://mcp.floid.app
Sandboxhttps://mcp.floid.app/sandbox
TransporteStreamable HTTP, sin sesión
AutenticaciónEncabezado 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.

HerramientaQué hace
buscar_herramientasBusca por palabras (consulta) y opcionalmente por fuente. Con 5 resultados o menos devuelve la ficha completa de cada una.
ejecutarEjecuta 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

  1. Llama buscar_herramientas con palabras del pedido del usuario, por ejemplo "carpeta tributaria".
  2. Lee la ficha: parámetros, bancos y avisos (por ejemplo, que una clave errada puede bloquear la cuenta).
  3. Llama ejecutar con el nombre exacto y credencial_token.
  4. Si meta.pagina.has_more es true, pide la siguiente página con el mismo caseid.
  5. Ante un error, sigue error.sugerencia; si reintentable es false, no reintenta igual.

Límites