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 createpara 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 enAuthorization: Bearer. - stdio con
teseladb mcp, que reenvía al puerto HTTP. La credencial va en la variable de entornoTESELADB_API_KEY, nunca en los argumentos.
{
"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. aggregaterechaza un pipeline con$outo$merge, que el servidor MCP no admite.
Ver también
- Conectar un agente con MCP, una guía paso a paso.
- API REST, que usa las mismas claves de API.