Servidor MCP

Conecta un agente de IA a TeselaDB con las herramientas de MongoDB MCP Server.

Cada nodo tiene un servidor del Model Context Protocol. Tiene las herramientas de base de datos de MongoDB MCP Server con sus mismos nombres y argumentos: find, aggregate, count, insert-many, update-many, delete-many, create-index, collection-indexes, collection-schema y las demás.

Requisitos

  • Una clave de API creada con teseladb admin apikey create para un usuario con los roles que necesita el agente.
  • Acceso desde el cliente MCP al puerto 27080 de un nodo.

Dos formas de conectar

  • Streamable HTTP en https://<nodo>:27080/mcp, con una clave de API en Authorization: Bearer.
  • stdio con teseladb mcp, que reenvía al puerto HTTP. La credencial va en la variable de entorno TESELADB_API_KEY, nunca en los argumentos.
JSON
{
  "mcpServers": {
    "teseladb": {
      "command": "teseladb",
      "args": ["mcp", "--uri", "https://node-01:27080"],
      "env": { "TESELADB_API_KEY": "tdb_…" }
    }
  }
}

Solo lectura por defecto

El servidor MCP arranca en solo lectura: las herramientas que escriben no están disponibles hasta que las activas con el parámetro de clúster mcpOptions. aggregate rechaza $out y $merge. El registro de auditoría guarda cada llamada, y cada herramienta comprueba los privilegios del comando equivalente con los roles de la clave antes de ejecutarse.

Comprobar

El cliente MCP lista las herramientas del servidor. Con el modo por defecto, solo aparecen las que leen.

Problemas frecuentes

  • El cliente no ve las herramientas que escriben porque el servidor arranca en solo lectura. Actívalas con el parámetro de clúster mcpOptions.
  • aggregate rechaza un pipeline con $out o $merge, que el servidor MCP no admite.

Ver también