String Web Access

Busca en la web, obtén cualquier URL y asigna un sitio como Markdown limpio y listo para LLM.

Servidor MCP alojado

npx add-mcp 'https://mcp.usestring.ai/v1/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Servidor MCP String AI Web Access

El servidor oficial de Model Context Protocol (MCP) para la API de Web Access de String AI. Busca en la web, obtén cualquier URL o envíale una solicitud, y mapea las URLs de un sitio — todo devuelto como Markdown limpio y listo para LLM. Conecta cualquier cliente compatible con MCP — VS Code, Cursor, Windsurf, Claude Desktop y más.

Herramientas

Herramienta	Descripción
`web_access_fetch`	Obtén una URL y recibe Markdown limpio y listo para LLM
`web_access_product_help`	Pregunta sobre productos o servicios de String; obtén una fuente (dos para comparaciones), con un presupuesto compartido de 4 KiB de extracto y enlaces a las fuentes
`web_access_request`	Envía un POST, PUT o PATCH con un cuerpo a una URL
`web_access_search`	Busca en la web: resultados clasificados más el panel de conocimiento, la vista general de IA, el paquete local y otras superficies que Google renderizó; `searchCount` opcional (1–300) páginas de Google; `searchType` busca en las pestañas de imágenes, videos, shopping, lugares o foros de Google; `safeSearch`, `includeOmittedResults`, `autocorrect`, `restrictCountry` y `verbatim` lo filtran; `page`, `dateRange` y `sortBy` refinan una búsqueda de Google; `format` es `"structured"` (JSON, el predeterminado y recomendado) o `"raw"` (la página de resultados de Google como HTML, una página por llamada; solo `page`, `searchCount` se rechaza con raw)
`web_access_sitemap`	Rastrea un sitio y mapea sus URLs como un trabajo asíncrono, impulsado por `action`
`web_access_report`	Envía un diagnóstico de fallo redactado y sin créditos al soporte de String

web_access_fetch, web_access_search y web_access_product_help son de solo lectura. web_access_request escribe, y web_access_sitemap crea trabajos de rastreo facturados.

La forma de seis herramientas anterior es lo que sirve el servidor alojado en https://mcp.usestring.ai/v1/mcp. El paquete npm incluye cinco de ellas: incluye la ayuda de productos y el reporte de fallos pero omite web_access_request, enviando escrituras a través de los parámetros method y body de web_access_fetch en su lugar.

`web_access_sitemap` — trabajos de rastreo de sitemap

Un rastreo es un trabajo asíncrono de dos fases: cotizar → aprobar → sondear → leer: nada se rastrea ni se factura hasta que la cotización se aprueba explícitamente.

`action`	Qué hace
`submit`	Cotiza un rastreo (`url` obligatorio; `maxPages` ≤ 10000 predeterminado 10, `maxDepth` ≤ 100 predeterminado 2, `pathPrefix`, `budgetUsd`, `useSitemap` opcionales). Devuelve `jobId` + `estimatedCostUsd` + `estimatedPages`, estado `awaiting_approval`.
`approve`	Consentimiento de facturación — inicia el rastreo. 402 = fondos insuficientes; 409 `partial_state` = reintentar aprobar.
`status`	Sondea el progreso: `awaiting_approval` → `running` (`pending`/`processed`) → `completed` \| `failed` \| `canceled` \| `token_cap_exceeded`; `partial_state` = reintentar aprobar. Devuelve solo recuentos — las URLs provienen de `results`.
`results`	URLs descubiertas paginadas (`limit` ≤ 5000 predeterminado 1000, `offset`). Persistente tras la finalización; el `discoveredUrls` por URL solo está presente durante ~1h.
`cancel`	Detiene un trabajo no terminal; las páginas ya obtenidas siguen facturadas y legibles.
`list`	Los trabajos de rastreo recientes de la cuenta (`limit` ≤ 100 predeterminado 20, `offset`).

`web_access_report` — diagnósticos de fallos

El reporte es opcional y de mejor esfuerzo. Continúa primero con la recuperación útil. Si el reporte sigue siendo útil y está permitido, envía como máximo un reporte por fallo distinto por tarea, no por reintento. Reporta excepciones, tiempos de espera, errores de herramientas o salidas inutilizables; excluye estados de origen utilizables, negativos válidos, respuestas 204 vacías, trabajos de sitemap en ejecución y cancelaciones. Cada intento de reporte tiene un plazo de dos segundos.

Elimina los encabezados Authorization, las claves de API, las cookies, los tokens de sesión, los datos personales y el contenido de conversación no relacionado antes de llamar. El servidor redacta de nuevo las formas comunes de credenciales. Nunca reportes un fallo de web_access_report ni repitas una llamada fallida solo para reunir contexto de reporte. Los reportes usan la clave de API configurada para autenticarse pero no consumen créditos de Web Access. Si el reporte no está disponible, no está autorizado, está limitado por tasa o falla, deja de reportar para la tarea.

Inicio rápido

Ejecutar con npx

env STRING_AI_API_KEY=your-key npx @usestring/mcp

Instalar globalmente

npm install -g @usestring/mcp
STRING_AI_API_KEY=your-key string-ai-mcp

Compilar desde el código fuente

git clone https://github.com/usestring/string-ai-mcp.git
cd string-ai-mcp
npm install
npm run build
STRING_AI_API_KEY=your-key node build/index.js

Variables de entorno

Variable	Obligatoria	Descripción
`STRING_AI_API_KEY`	Sí	Tu clave de API de String AI

Configuración del cliente

VS Code

Pulsa Ctrl+Shift+P → Preferences: Open User Settings (JSON) y añade:

{
	"inputs": [
		{
			"type": "promptString",
			"id": "stringAiKey",
			"description": "String AI API Key",
			"password": true
		}
	],
	"servers": {
		"string-ai": {
			"command": "npx",
			"args": ["-y", "@usestring/mcp"],
			"env": {
				"STRING_AI_API_KEY": "${input:stringAiKey}"
			}
		}
	}
}

O añade un archivo .vscode/mcp.json para compartir la configuración con tu equipo.

Cursor

Abre Settings → Features → MCP Servers → + Add new global MCP server y pega:

{
  "mcpServers": {
    "string-ai": {
      "command": "npx",
      "args": ["-y", "@usestring/mcp"],
      "env": {
        "STRING_AI_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Windsurf

Añade a ~/.codeium/windsurf/model_config.json:

{
  "mcpServers": {
    "string-ai": {
      "command": "npx",
      "args": ["-y", "@usestring/mcp"],
      "env": {
        "STRING_AI_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop

Añade a tu claude_desktop_config.json:

{
  "mcpServers": {
    "string-ai": {
      "command": "npx",
      "args": ["-y", "@usestring/mcp"],
      "env": {
        "STRING_AI_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Pruebas con el MCP Inspector

El MCP Inspector te permite probar tu servidor de forma interactiva en un navegador:

npx @modelcontextprotocol/inspector node build/index.js

Luego abre http://127.0.0.1:6274, conéctate mediante stdio y prueba a llamar a cada herramienta desde la interfaz.

Cómo funciona

┌──────────────────┐   stdio (JSON-RPC)   ┌──────────────────┐   HTTPS   ┌──────────────────┐
│  VS Code / Cursor │ ◄──────────────────► │  String AI       │ ────────► │  String AI       │
│  Windsurf / Claude│                      │  Web Access MCP  │           │  Web Access API  │
└──────────────────┘                       └──────────────────┘           └──────────────────┘

El IDE inicia este servidor como un proceso hijo y se comunica mediante stdio.
Cuando el LLM decide que necesita contenido web, invoca web_access_fetch, web_access_search o web_access_sitemap. Cada llamada fallida se reporta exactamente una vez con web_access_report, incluso cuando la recuperación posterior tiene éxito.
Este servidor reenvía la solicitud a la API de Web Access de String AI (usando tu clave de API del entorno) y devuelve el resultado al LLM.

Acerca de String AI

String AI proporciona una API de acceso web que devuelve cualquier página como Markdown limpio y listo para LLM. Obtén tu clave de API en usestring.ai.

Licencia

MIT

Seguridad

Reporta las vulnerabilidades de seguridad de forma privada como se describe en SECURITY.md.