import { CardGrid, LinkCard } from '@astrojs/starlight/components';
import Faq from '@components/Faq.astro';

**Aymar Agents** tiene su propio servidor **MCP** ([Model Context Protocol](https://modelcontextprotocol.io)):
expone tu cuenta — leads, contactos, conversaciones, citas y tickets — como un conjunto de *tools* que tu
asistente de IA puede leer y, con tu confirmación, escribir. Es exactamente lo que permite la API pública, ni
un endpoint más — sus tools se generan de la misma definición OpenAPI.

<CardGrid>
  <LinkCard title="Qué es y qué no es" href="/mcp/getting-started/" description="Un adaptador determinista sobre tu propia API pública, sin modelo de lenguaje propio." />
  <LinkCard title="Conectar tu asistente" href="/mcp/connect/" description="URL, cabecera X-Api-Key y transporte Streamable HTTP." />
</CardGrid>

## Conecta tu cliente

<CardGrid>
  <LinkCard title="Claude Desktop" href="/mcp/clients/claude-desktop/" description="Configuración del cliente de escritorio." />
  <LinkCard title="Claude Code" href="/mcp/clients/claude-code/" description="Por CLI o con .mcp.json." />
  <LinkCard title="Cursor" href="/mcp/clients/cursor/" description="Configuración del editor." />
</CardGrid>

## Referencia

<CardGrid>
  <LinkCard title="Catálogo de tools" href="/mcp/tools/" description="Cada tool disponible, generada de la misma definición OpenAPI que la API pública." />
  <LinkCard title="La confirmación en escrituras" href="/mcp/confirm/" description="Ninguna escritura ocurre sin tu confirmación explícita." />
  <LinkCard title="Límites, errores y resolución de problemas" href="/mcp/troubleshooting/" description="Qué hacer cuando algo falla." />
</CardGrid>

## Herramientas relacionadas

<CardGrid>
  <LinkCard title="Referencia API" href="/api/" description="La misma superficie, en REST directo." />
  <LinkCard title="llms.txt" href="/llms.txt" description="Índice de todo el portal en texto plano." />
</CardGrid>

## Preguntas frecuentes

<Faq items={[
  { question: '¿En qué se diferencia el servidor MCP propio de un servidor MCP externo (BYO-MCP)?', answer: 'Son direcciones opuestas: el servidor MCP de Aymar Agents saca tu cuenta hacia tu asistente de IA externo (Claude Desktop, Claude Code, Cursor); un servidor MCP externo mete herramientas de terceros dentro del agente que atiende a tus clientes, y se conecta desde Ajustes, no desde tu cliente MCP. Ver <a href="/mcp/getting-started/">Qué es y qué no es</a>.' },
  { question: '¿Qué necesito para conectar mi cliente MCP?', answer: 'Un plan Pro o Enterprise y una clave de API con los scopes de los recursos que quieras usar — el mismo mecanismo que usarías para llamar a /public/v1 directamente.' },
  { question: '¿El servidor MCP puede hacer más cosas que la API pública?', answer: 'No — sus tools se generan leyendo la misma definición OpenAPI que /public/v1. Cualquier cosa que puedas hacer por MCP también podrías hacerla con una llamada curl directa a la API.' },
  { question: '¿Por qué mi asistente pide confirmación antes de crear o cambiar algo?', answer: 'Toda tool de escritura exige el argumento confirm: true; sin él, el servidor la rechaza antes de tocar la API y devuelve un resumen de lo que iba a hacer. Es el mismo principio de "el LLM nunca es la única barrera" que rige el resto del producto. Ver <a href="/mcp/confirm/">La confirmación en escrituras</a>.' },
  { question: '¿Puede una tool de MCP borrar datos?', answer: 'No — ninguna tool puede borrar nada, porque la API pública no tiene ningún endpoint DELETE.' },
  { question: 'Solo veo la tool de estado en mi cliente MCP, nada más. ¿Por qué?', answer: 'O tu tenant no está en un plan Pro/Enterprise, o tu clave no tiene ningún scope de lectura. Llama a la tool de estado para confirmar cuál de los dos es. Ver <a href="/mcp/troubleshooting/">Límites, errores y resolución de problemas</a>.' },
]} />

## Siguiente

<LinkCard title="Conectar tu asistente" href="/mcp/connect/" description="Bloques de configuración para Claude Desktop, Claude Code y Cursor." />