Servidores MCP

Perch puede conectarse a sistemas externos mediante el Model Context Protocol, o MCP. Esto le permite a Perch llegar a datos y herramientas que no son archivos en tu disco: bases de datos jurídicas, automatización del navegador, APIs internas, cualquier cosa que hable MCP. Las herramientas de los servidores conectados aparecen junto a las herramientas integradas de Perch, y el modelo puede llamarlas directamente.

Lo que viene de forma predeterminada

Cuando abres Perch Terminal Desktop por primera vez, crea un archivo de configuración en ~/.perch/mcp.json con dos servidores ya configurados:

• CourtListener. Un servidor de investigación jurídica que puede buscar jurisprudencia, consultar citas, recuperar el texto de las sentencias, encontrar casos relacionados y traer entradas de expedientes. Se conecta a la base de datos de CourtListener, que cubre tribunales federales y estatales. Incluye un token de API, así que funciona desde el primer inicio sin configuración.
• Playwright. Un servidor de automatización del navegador fijado a una versión probada de @playwright/mcp. Es lo que impulsa las acciones de Perch en el navegador: navegar por páginas, hacer clic en elementos, escribir en campos y leer lo que hay en pantalla.

No necesitas instalar ni configurar ninguno de los dos. Se conectan automáticamente cuando Perch inicia.

Cómo llegan las herramientas al modelo

Cuando un servidor MCP se conecta, Perch lee su lista de herramientas y convierte cada una en una definición para el modelo. La convención de nombres es mcp__<serverName>__<toolName>. Por ejemplo, la búsqueda de casos de CourtListener se convierte en mcp__courtlistener__search_cases, y aparece junto a herramientas integradas como readLocalFile o webSearch.

El modelo ve estas herramientas como de primera clase. Puede llamarlas en el mismo ciclo que cualquier otra herramienta, y los resultados vuelven como contenido estructurado que Perch puede citar y sobre el que puede actuar.

Configuración global y por carpeta

Los servidores MCP se pueden configurar en dos niveles:

• Global. El archivo en ~/.perch/mcp.json se aplica a todas las sesiones de Perch en tu computadora. Aquí es donde están configurados los servidores predeterminados.
• Por carpeta. Un archivo .perch/mcp.json dentro de la carpeta de tu espacio de trabajo se aplica solo cuando trabajas en esa carpeta. La configuración de la carpeta reemplaza a la global según el nombre del servidor, así puedes sustituir un servidor global por otro para un proyecto específico.

Se admite la expansión de variables de entorno. Si un servidor necesita una clave de API, puedes hacer referencia a ella como ${YOUR_API_KEY} en la configuración y Perch la expandirá a partir de tu entorno.

Agregar tu propio servidor

Para agregar un servidor MCP, edita ~/.perch/mcp.json (para la configuración global) o .perch/mcp.json en la carpeta de tu espacio de trabajo (para un proyecto específico). La estructura es:

{
  "servers": {
    "my-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@some-org/some-mcp-server"],
      "env": {
        "API_KEY": "${MY_API_KEY}"
      }
    }
  }
}

Se admiten tres tipos de transporte:

• stdio. Ejecuta un proceso local. Requiere un command y, de forma opcional, args y env.
• http. Se conecta a un endpoint HTTP remoto. Requiere una url y, de forma opcional, headers.
• sse. Se conecta a un endpoint SSE remoto. Requiere una url y, de forma opcional, headers.

Después de editar la configuración, reinicia Perch o ejecuta el comando de reconexión. El nuevo servidor se conecta en el siguiente inicio.

Dónde encaja MCP

MCP es para sistemas en vivo que no se pueden representar como archivos en una carpeta. Si los datos ya están en tu disco como hoja de cálculo, PDF o CSV, Perch los lee directamente a través del puente de carpetas. MCP es para todo lo demás: bases de datos externas, APIs y servicios que requieren un proceso en ejecución o autenticación.

El operador y los agentes→

Cómo Perch va más allá del chat para leer archivos, ejecutar análisis y coordinar workers.

Seguridad y datos→

Cómo maneja Perch tus archivos y tus datos, y qué se procesa fuera de tu dispositivo.