Ir al documento

Conectar Letta con Neotoma

Letta Agent SDK puede añadir herramientas MCP de Neotoma a una sesión. Configura el endpoint en la aplicación SDK y verifica las herramientas de esa sesión.

Fuente de esta traducción: docs/guides/connections/es/letta.md · Leer Markdown · Original en inglés: docs/guides/connections/letta.md · Leer original · 08598d0

Una sesión de Letta se comunica con un endpoint de Neotoma.
La integración de herramientas del lado servidor de Letta debe alcanzar el endpoint de Neotoma configurado con el acceso requerido.

Referencia publicada: v0.26.0 (b6ae615, 27 de octubre de 2026). La vía se examinó en el código 4779784 y en la documentación del proveedor el 24 de octubre de 2026; ese código está incluido en la versión publicada. La compatibilidad con la versión instalada del entorno y con Windows no se probó.

Vía: configuración de una sesión de Letta Agent SDK para un endpoint MCP de Neotoma.

Antes de conectar

Registrar el servidor en la sesión cambia las herramientas disponibles en Letta, mientras los datos de Neotoma permanecen en el endpoint operado. Lee qué cambia en tu sistema antes de añadirlo.

Usa el selector de conexión para personas para comparar las vías compatibles. Para la sesión de Letta Agent SDK, utiliza un endpoint HTTPS /mcp de Neotoma ya operado, accesible y autenticado. El registro no instala Neotoma en la máquina cliente de Letta. Comprueba la API de sesiones actual y no guardes credenciales en archivos de proyecto compartidos.

Configurar

Opera un endpoint HTTPS /mcp de Neotoma accesible y autenticado. En el Letta Agent SDK actual, pásalo en mcpServers al crear o reanudar una sesión:

ts
await using session = client.resumeSession("YOUR_AGENT_ID", {
  mcpServers: {
    neotoma: {
      type: "http",
      url: "https://YOUR-HOST/mcp",
      headers: { Authorization: `Bearer ${process.env.NEOTOMA_TOKEN}` },
    },
  },
});

Usa la inicialización de LettaAgentClient de la guía actual de Letta. Estas herramientas pertenecen a la sesión SDK, no quedan guardadas en el agente de Letta. La guía antigua de Neotoma describe un registro V1 mediante mcp_servers.create(); no lo copies en una aplicación Agent SDK actual sin comprobar su versión. Neotoma no tiene opción setup --tool letta. La dirección importa: el servidor MCP alojado por Letta expone agentes de Letta a otros clientes; esta vía da a un agente de Letta herramientas de Neotoma.

Verifica que la sesión expone mcp__neotoma__retrieve_entities y pide al agente que la llame. Si la inicialización termina pero el agente no ve herramientas de Neotoma, examina primero el resultado de la conexión MCP de la sesión y la autenticación del endpoint, antes de investigar los datos.

Verificar y recuperar

Examina las herramientas MCP de la sesión y llama a retrieve_entities para una entidad conocida. Si no aparece la herramienta, compara la versión del SDK y el formato de registro por sesión. Una consulta vacía no demuestra que el perfil de datos esté vacío: comprueba un caso conocido que debe dar resultado.

Fuentes