> For the complete documentation index, see [llms.txt](https://docs.neuron-ai.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.neuron-ai.dev/neuron-v3-es/agente/mcp-connector.md).

# MCP

Conecta las herramientas proporcionadas por los servidores del Protocolo de Contexto de Modelo (MCP) a tu agente.

MCP (Model Context Protocol) es un estándar de código abierto diseñado por Anthropic para conectar tus agentes con proveedores de servicios externos, como la base de datos de tu aplicación o APIs externas.

Gracias a este protocolo puedes poner a disposición de tu agente las herramientas expuestas por un servidor externo.

Las empresas pueden crear servidores MCP para permitir a los desarrolladores conectar agentes a sus plataformas. Aquí tienes un par de directorios con los servidores MCP más utilizados:

* GitHub oficial de MCP - <https://github.com/modelcontextprotocol/servers>
* Registro MCP-GET - <https://mcp-get.com/>

### Cómo funciona

Neuron te proporciona la `McpConnector` clase que puedes instanciar pasando la configuración del servidor MCP.

```php
use NeuronAI\MCP\McpConnector;

class MyAgent extends Agent 
{
    ...
    
    protected function tools(): array
    {
        return [
            ...McpConnector::make([
                'command' => 'php',
                'args' => ['/home/code/mcp_server.php'],
            ])->tools(),
        ];
    }
}
```

Debes crear una `McpConnector` instancia para cada servidor MCP con el que quieras interactuar.

Neuron descubre automáticamente las herramientas expuestas por el servidor y las conecta a tu agente.

Cuando el agente decide ejecutar una herramienta, Neuron generará la solicitud adecuada para llamar a la herramienta en los servidores MCP y devolverá el resultado al LLM para continuar la tarea. Se siente exactamente como con tus propias herramientas definidas, pero puedes acceder a un enorme catálogo de acciones predefinidas que tu agente puede realizar con solo una línea de código.

### Servidor MCP local

Si quieres conectarte con un servidor MCP instalado localmente en tu máquina o VM, puedes usar la configuración estilo "command".

```php
use NeuronAI\MCP\McpConnector;

class MyAgent extends Agent 
{
    ...
    
    protected function tools(): array
    {
        return [
            ...McpConnector::make([
                'command' => 'php',
                'args' => ['/home/code/mcp_server.php'],
            ])->tools(),
        ];
    }
}
```

## Servidor MCP remoto

### Servidor HTTP transmisible

Los servidores remotos son accesibles mediante URL y normalmente requieren autenticación. Puedes usar el `token` campo en el array de configuración, que se utilizará como token de autorización para autenticarse en el servidor:

```php
use NeuronAI\MCP\McpConnector;

class MyAgent extends Agent 
{
    ...
    
    protected function tools(): array
    {
        return [
            ...McpConnector::make([
                'url' => 'https://mcp.example.com',
                'token' => 'BEARER_TOKEN',
                'timeout' => 30,
                'headers' => [
                    //'x-cutom-header' => 'value'
                ]
            ])->tools(),
        ];
    }
}
```

### Transporte HTTP SSE

SSE ([Eventos enviados por el servidor](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events)) es un mecanismo que permite a los clientes web recibir actualizaciones automáticas de un servidor. Esas actualizaciones se conocen como "eventos" y se envían a través de una única conexión HTTP persistente.

Para usar el transporte SSE, necesitas establecer `async ⇒ true` en los parámetros de configuración.

```php
use NeuronAI\MCP\McpConnector;

class MyAgent extends Agent 
{
    ...
    
    protected function tools(): array
    {
        return [
            ...McpConnector::make([
                'url' => 'https://mcp.example.com',
                'token' => 'BEARER_TOKEN',
                'timeout' => 30,
                'async' => true
            ])->tools(),
        ];
    }
}
```

## Monitoreo y depuración

Muchas de las aplicaciones que construyas con Neuron contendrán múltiples pasos con múltiples invocaciones de llamadas a LLM. A medida que estas aplicaciones se vuelven cada vez más complejas, resulta crucial poder inspeccionar exactamente qué está ocurriendo dentro de tu sistema agéntico. La mejor manera de hacerlo es con [Inspector](https://inspector.dev/).

{% embed url="<https://docs.inspector.dev/guides/neuron-ai>" %}

## Filtrar la lista de herramientas

Durante la conexión con servidores MCP complejos, estos pueden incluir herramientas que podrían provocar comportamientos no deseados en contextos específicos. Los **`exclude()`** y **`only()`** métodos abordan este desafío de forma elegante, permitiéndote conectarte con grandes servidores MCP mientras mantienes un control detallado sobre las capacidades disponibles que quieres proporcionar al agente.

Estos métodos aceptan una lista de nombres de herramientas que sí quieres, o no quieres, asociar con el agente.

```php
class MyAgent extends Agent 
{
    ...
    
    protected function tools()
    {
        return [
            // EXCLUDE: descarta ciertas herramientas
            ...McpConnector::make([
                'url' => 'https://mcp.example.com',
            ]->exclude([
                'tool_name_1',
                'tool_name_2',
            ])->tools(),
            
            // ONLY: selecciona las herramientas que quieres incluir
            ...McpConnector::make([
                'url' => 'https://mcp.example.com',
            ]->only([
                'tool_name_1',
                'tool_name_2',
            ])->tools(),
        ];
    }
}
```

### Interactuar con instancias de herramientas

Si necesitas aplicar políticas específicas a las herramientas que provienen de un servidor MCP, como `requireApproval()` o `setMaxRuns()`, puedes extraer una instancia de herramienta usando **`with()`** método:

```php
class MyAgent extends Agent 
{
    ...
    
    protected function tools()
    {
        return [
            ...McpConnector::make([
                'url' => 'https://mcp.example.com',
            ]->with(
                name: 'tool_name_1',
                callback: fn (Tool $tool) => $tool->requireApproval()
            ])->tools(),
        ];
    }
}
```
