Conectar Packetrove a un agente de IA

Conecta un cliente MCP compatible para usar las herramientas de red de Packetrove. Configúralo siguiendo estos pasos y utiliza los ejemplos.

Streamable HTTP · Sin cuenta ni clave de API

https://api.packetrove.com/mcp

Conectar tu cliente

Con Claude Code o Codex instalado, añade este servidor remoto. Los comandos configuran el cliente; no instalan un servidor Packetrove local.

Claude Code

claude mcp add --transport http --scope user packetrove \
  https://api.packetrove.com/mcp
Documentación MCP de Claude Code

Codex

codex mcp add packetrove \
  --url https://api.packetrove.com/mcp
Documentación MCP de Codex

Usa /mcp en tu cliente para comprobar la conexión. Confirma que estas herramientas estén disponibles: cidr-cover, cidr-subtract, range-to-cidrs, certificate-bundle, public-ip.

Tras configurarlo, el cliente descubre las herramientas con tools/list. Las descripciones y los esquemas orientan la selección y los argumentos. Leer una página web no configura un cliente ni le concede acceso a herramientas.

Identidad del servidor

El servidor anuncia la siguiente identidad del servicio, con su versión de publicación. Los nombres, las descripciones y los esquemas de cada herramienta se enumeran por separado mediante tools/list.

{
  "name": "Packetrove",
  "title": "Packetrove",
  "description": "Open-source IP address and CIDR tools for network calculations and public IP lookup.",
  "websiteUrl": "https://packetrove.com",
  "icons": [
    {
      "src": "https://packetrove.com/packetrove-logo-32x32.png",
      "mimeType": "image/png",
      "sizes": [
        "32x32"
      ]
    }
  ],
  "version": "0.8.0"
}

Cada cliente decide si muestra el título, la descripción, el sitio web o el icono y puede ignorar los campos opcionales. El descubrimiento correcto del protocolo no demuestra que el cliente muestre esta información. El icono PNG mide 32×32 y no tiene restricción de tema.

Comentarios opcionales de agentes

submit-feedback es una operación opcional de soporte MCP, desactivada por defecto. Úsala solo cuando tools/list la anuncie. Envía un informe privado por correo al responsable para revisión humana; no hay envío desde el sitio web, Web API ni CLI.

Envía comentarios solo a petición del usuario o con su autorización. Puedes enviar directamente un informe aportado o aprobado. Muestra primero cualquier texto nuevo para obtener aprobación. No adjuntes conversaciones ni solicites comentarios después de cada llamada.

submit-feedback

category: bug, confusing_behavior o feature_request. Incluye summary y, opcionalmente, tool_name o synthetic_reproduction. Los errores requieren expected y actual; el comportamiento confuso, actual. Las funciones propuestas admiten expected, pero no actual ni error_code. summary: 256 puntos de código Unicode; expected/actual: 1024 cada uno; reproducción: 2048. error_code opcional usa mayúsculas. Se rechazan campos desconocidos; los argumentos serializados no deben superar 8 KiB.

Argumentos de ejemplo

{
  "category": "confusing_behavior",
  "tool_name": "cidr-cover",
  "summary": "Explain why a covering CIDR can include additional addresses.",
  "actual": "The result includes addresses beyond the supplied documentation inputs.",
  "synthetic_reproduction": "Use documentation addresses 203.0.113.1 and 203.0.113.6."
}

Resultado de ejemplo con direcciones de documentación

{
  "status": "accepted",
  "receipt_id": "00000000-0000-4000-8000-000000000001"
}

Los límites aproximados son 10 envíos por IP de salida observada en las últimas 24 horas y 100 por día UTC para todo el servicio. Las salidas compartidas comparten cuota. Las solicitudes concurrentes y la propagación de KV pueden superar ambos límites. Los envíos inciertos o las liberaciones fallidas ocupan cuota hasta caducar. Los cálculos y consultas no se ven afectados.

accepted y receipt_id indican que el servicio de correo aceptó el envío, no que llegó a la bandeja de entrada o se leyó. No se promete respuesta ni solución. El rechazo confirmado devuelve delivery: not_accepted. Nunca reenvíes automáticamente tras un tiempo de espera, cancelación o DELIVERY_UNCERTAIN: el informe puede haberse enviado por correo. No hay deduplicación.

Al activarse, submit-feedback envía el informe autorizado, el recibo, la versión pública del servicio y la hora de envío por correo a través de Cloudflare al responsable para revisión humana. Usa ejemplos sintéticos; excluye datos reales de red, certificados, secretos, registros e historial de conversaciones. La conservación y eliminación en el buzón se gestionan manualmente; los informes no caducan automáticamente. Cloudflare Workers KV guarda por separado solo marcadores de IP de salida derivados con clave y horas de reserva, que caducan tras 24 horas, sin el contenido del informe ni vínculos al recibo. Los marcadores no se adjuntan a informes ni se registran. Eliminar un correo no restaura la cuota. Solicita la eliminación por correo al responsable con el recibo. Los informes no se publican automáticamente.

Política de privacidad

Leer resultados y gestionar errores

Lee structuredContent o el JSON del bloque de texto. Conserva los recuentos como cadenas decimales o enteros de precisión arbitraria; convertir grandes recuentos IPv6 a números de coma flotante pierde precisión.

Las respuestas correctas de cálculos y consultas conservan el resultado en structuredContent y en el primer bloque de texto JSON, y añaden un resource_link opcional a la página de la herramienta en inglés. Los enlaces no contienen entradas ni resultados y no restauran el cálculo. Cada cliente decide si muestra, ignora o abre los enlaces; no se garantiza su presentación o cita automática. Abrir la página de IP pública comprueba una nueva conexión del navegador, que puede diferir de la conexión del cliente MCP. Los errores no incluyen enlaces a la herramienta.

Si isError es true, lee el error JSON antes de reintentar. Corrige INVALID_INPUT y MIXED_ADDRESS_FAMILIES con la información del usuario. CLIENT_IP_UNAVAILABLE indica que faltan metadatos fiables de conexión; no inventes una dirección.

Los errores de negocio usan el JSON de error compartido. El SDK de MCP valida el protocolo. El HTTP rechaza JSON inválido, tipos de contenido no admitidos y cuerpos demasiado grandes.

Ejecutar un ejemplo de Node.js

En un directorio nuevo, guarda el código como packetrove-example.mjs y ejecuta los comandos. El ejemplo usa @modelcontextprotocol/client@2.0.0, descubre herramientas e invoca la herramienta CIDR con direcciones de documentación.

import { Client, StreamableHTTPClientTransport } from '@modelcontextprotocol/client';

const client = new Client(
  { name: 'packetrove-example', version: "0.8.0" },
  { versionNegotiation: { mode: 'auto' } },
);
try {
  await client.connect(new StreamableHTTPClientTransport(new URL("https://api.packetrove.com/mcp")));
  const serverInfo = client.getServerVersion();
  const { tools } = await client.listTools();
  const result = await client.callTool({
    name: "cidr-cover",
    arguments: {"inputs":["203.0.113.1","203.0.113.2","203.0.113.6"]},
  });
  if (result.isError) throw new Error(JSON.stringify(result.content));
  console.log(serverInfo, tools.map(tool => tool.name), result.structuredContent);
  const links = result.content?.filter(content => content.type === 'resource_link') ?? [];
  console.log(links); // Optional links; opening or presenting them is the client's choice.
} finally {
  await client.close();
}
npm init -y
npm install @modelcontextprotocol/client@2.0.0
node packetrove-example.mjs

Para el desarrollo local, inicia pnpm dev:api y cambia la URL del servidor del ejemplo por http://localhost:8787/mcp.

Despliegue y límites de conexión

El servidor admite solicitudes modernas sin estado e inicialización, descubrimiento y llamadas del transporte Streamable HTTP anterior. No ofrece sesiones persistentes ni flujos de eventos independientes del servidor.

Los metadatos de la IP pública se leen en cada llamada y las instancias del servidor se aíslan entre clientes concurrentes. Los resultados y errores MCP usan Cache-Control: no-store, no-transform. La aplicación no conserva ni registra las direcciones consultadas.

Contamos las ejecuciones con eventos operativos que contienen el nombre de la herramienta, éxito o error, un código de error controlado y una clasificación del origen de la llamada. Las comprobaciones automáticas verificadas también pueden registrar un identificador de ejecución de automatización. Se excluyen entradas, resultados, direcciones consultadas, cabeceras de solicitud sin procesar y tokens de automatización. Cloudflare puede añadir metadatos de la solicitud; la política de privacidad explica el tratamiento y la conservación.

Los nombres anteriores no tienen alias de compatibilidad: smallest_covering_cidr → cidr-cover, subtract_cidrs → cidr-subtract, get_public_ip → public-ip. Actualiza el descubrimiento de herramientas y las llamadas guardadas.

La ruta /mcp del sitio no es el servicio: GET devuelve 404 y POST 405, sin reenviar ni redirigir llamadas. Configura los clientes con https://api.packetrove.com/mcp. En tu despliegue, actualiza los dominios y las listas exactas separadas de Host y Origin del navegador; se admiten clientes sin cabecera Origin.

Despliegue, alojamiento propio y verificación de producciónPolítica de privacidadPublicación en MCP Registry y política de versionesLeer la guía técnica MCP del repositorio (inglés)