Resumen
API de Tenderplan (tenderplan.ru) para el monitoreo de licitaciones rusas: licitaciones encontradas por tus claves guardadas, marcas, datos completos de licitaciones con protocolos, contratos y quejas, búsqueda de licitaciones con análisis, comentarios, tareas, organizaciones con datos de EGRUL, el registro de proveedores no confiables, notificaciones y el calendario de licitaciones. Token de acceso personal.
Configuración guiada
Conecta Tenderplan a Gemini en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Tenderplan con la configuración guiada y añade tu URL MCP a Gemini. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para Tenderplan
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Tenderplan, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
Tenderplan + Gemini
API de Tenderplan (tenderplan.ru) para el monitoreo de licitaciones rusas: licitaciones encontradas por tus claves guardadas, marcas, datos completos de licitaciones con protocolos, contratos y quejas, búsqueda de licitaciones con análisis, comentarios, tareas, organizaciones con datos de EGRUL, el registro de proveedores no confiables, notificaciones y el calendario de licitaciones. Token de acceso personal.
Requisitos previos
Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
TENDERPLAN_API_TOKEN
Paso 1 — Obtener credenciales
La configuración tarda unos 3 minutos.
- Inicia sesión en https://tenderplan.ru/app y abre la configuración de tu perfil, pestaña Интеграции с сервисами (Integraciones con servicios).
- En el bloque Тендерплан API haz clic en Настроить (Configurar), escribe un nombre bajo Название токена y marca los permisos bajo Выберите права, которые будут передаваться по API. Para todas las herramientas marca
firm:read,user:read,users:read,keys:read,marks:read,relations:read,relations:write,resources:external,resources:personal,comments:read,comments:write,notifications:readycalendar:read. Para una configuración de solo lectura, deja fuera los dos permisoswrite. - Haz clic en Сгенерировать токен (Generar token), copia el token y pégalo en
TENDERPLAN_API_TOKEN. Tus tokens se enumeran bajo Мои токены, donde un token puede ser revocado.
Tu rol en Tenderplan debe tener permitido agregar acceso a la API; si falta el bloque de API, pregunta al administrador de tu empresa. El token se envía como Authorization: Bearer. Un token de acceso OAuth 2.0 de una aplicación registrada en Tenderplan funciona en el mismo campo (un token de credenciales de cliente solo para las herramientas que necesitan resources:external); el conector no renueva tokens.
Dónde empezar: tenderplan_get_firm prueba que el token funciona y tenderplan_get_current_user indica para quién actúa. tenderplan_list_keys (búsquedas guardadas) y tenderplan_list_marks (etiquetas) dan los ids para tenderplan_list_tenders; tenderplan_get_tender lee una licitación en su totalidad. tenderplan_list_reference_values traduce los ids numéricos para estado, forma de colocación, plataforma y región.
Licitaciones: tenderplan_list_tenders lista las licitaciones monitoreadas por una clave o marca; tenderplan_filter_tenders es la lista más nueva con filtros de estado, ventana de fechas, tipo, comentario y tarea, y tenderplan_list_saved_filters muestra los filtros que el usuario guardó para ello. tenderplan_search_tenders busca en toda la base de datos con condiciones clave y devuelve licitaciones o análisis sobre clientes, participantes y productos. tenderplan_find_tender_by_number convierte un número de aviso en un id de Tenderplan. tenderplan_get_tender_related_info devuelve los registros relacionados de una licitación en una sola llamada, tenderplan_list_tender_records un tipo a la vez (protocolos, contratos, etapas, explicaciones, quejas, garantías bancarias, entradas de РНП, adjuntos).
Trabajo en equipo: tenderplan_list_comments y tenderplan_add_comment; tenderplan_list_open_tasks, tenderplan_list_tender_tasks, tenderplan_add_task y tenderplan_complete_task; tenderplan_add_tender_marks y tenderplan_mark_tenders_read; tenderplan_list_users para ids de usuarios; tenderplan_list_notifications y tenderplan_list_calendar_events. tenderplan_remove_tender_marks se instala desactivado: actívalo solo si el asistente puede quitar etiquetas de las licitaciones.
Organizaciones: tenderplan_search_organizations encuentra un cliente o proveedor por nombre o INN; tenderplan_get_organization, tenderplan_get_organization_egrul y tenderplan_get_organization_contacts leen su perfil, datos de registro y personas de contacto; tenderplan_list_rnp_records verifica un proveedor contra el registro de proveedores no confiables.
Notas de campo
- Ids de licitaciones, claves, marcas, usuarios, tareas, comentarios y organizaciones son cadenas hexadecimales de 24 caracteres. El número de aviso (
number) es algo diferente: resuélvelo primero. - Fechas son tiempo Unix en milisegundos (
1647873410678), en filtros y en respuestas. Los tiempos de licitación son momentos, no fechas locales: conviértelos para el usuario (Moscú es UTC+3). - Códigos son números:
status1 aceptando ofertas, 2 comisión en trabajo, 3 colocación finalizada, 4 cancelada, 5 fallida, 6 ejecución finalizada, 7 en ejecución, 8 terminada;kind0 licitación, 1 entrada de plan de programación, 2 solicitud de precio;placingWay,type(plataforma) yregionprovienen de las listas de referencia. - Precios:
maxPricees el precio máximo inicial del contrato (НМЦ) en lacurrencyde la licitación. - Paginación:
pagecomienza en 0 y el tamaño de la página es fijo por Tenderplan; sigue leyendo hasta que una página vuelva vacía. Abre la página de tareas concursor, organizaciones confromysize. - Palabras de búsqueda en las listas de licitaciones necesitan al menos 3 caracteres.
- Respuestas no documentadas: la documentación pública describe las respuestas de las llamadas de búsqueda, comentario, tarea, РНП y filtros guardados; para las otras llamadas lee los campos de la respuesta misma.
- Límites de tasa: como máximo 100 llamadas en 10 segundos y 500 en 60 segundos por usuario; listas de licitaciones 60 por minuto,
tenderplan_get_tender300 por minuto. Sobre el límite, la API responde 429: espera un minuto. - Permisos: cada descripción de herramienta nombra el permiso que necesita; un 403 significa que el token fue creado sin él. Las herramientas de tareas necesitan
tasks:readytasks:write, que la lista de permisos publicada no muestra: si responden 403, este token no puede usar tareas. - No incluido: pedidos, facturas y compras de tarifas, edición de claves y marcas, administración de usuarios y cargas de archivos. Ninguna herramienta mueve dinero.
Paso 2 — Instalar el adaptador
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Paso 3 — Agregar el conector en Gemini
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de
YOUR_MCP_API_KEY. - Guarda el archivo y reinicia
gemini. - Ejecuta
/mcpdentro de Gemini CLI (ogemini mcp listen tu terminal):anythingmcpdebería aparecer como conectado. - Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de
Tenderplan.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
tenderplan_get_firm | Lee la firma (cuenta de empresa) a la que pertenece el token: el registro de la firma de tu cuenta de Tenderplan. La llamada más barata para probar que el token… |
tenderplan_get_current_user | Lee el usuario para el que actúa el token: el propio registro de ese usuario. Usa el _id del usuario como usuario responsable, asignado a la tarea o mención en los otros… |
tenderplan_list_users | Lista los usuarios de tu firma en Tenderplan. Usa sus ids para filtros de user_ids, como assignee_id de tarea y para menciones en comentarios. Sin paginación… |
tenderplan_list_keys | Lista las claves de la firma: las búsquedas guardadas que Tenderplan ejecuta continuamente para recopilar nuevas licitaciones. Una clave tiene un id, un nombre y condiciones de búsqueda… |
tenderplan_list_marks | Lista las marcas de la firma: las etiquetas que los usuarios ponen en las licitaciones para clasificarlas y rastrear el trabajo en ellas. Pasa un id de marca como mark_id para… |
tenderplan_list_tenders | Lista los modelos cortos de las licitaciones que tu firma monitorea, filtradas por una clave (búsqueda guardada) o una marca (etiqueta). La documentación describe el… |
tenderplan_filter_tenders | Lista las licitaciones monitoreadas con el filtro más nuevo y rico (versión de lista 2): elige un subconjunto (por clave, marca, usuario, bin, solicitudes legales o tareas)… |
tenderplan_get_tender | Lee el modelo completo de una licitación por su id de Tenderplan: todo lo que Tenderplan tiene sobre el aviso, más allá del modelo corto de la lista… |
tenderplan_get_tender_related_info | Lee lo que sucedió alrededor de una licitación en una sola llamada: los registros relacionados que Tenderplan recopiló para ella, como protocolos, contratos y… |
tenderplan_list_tender_records | Lista un tipo de registro adjunto a una licitación: protocolos, contratos, etapas de contrato, explicaciones (aclaraciones de la documentación)… |
tenderplan_search_tenders | Busca en toda la base de datos de licitaciones de Tenderplan (no solo tus licitaciones monitoreadas) con condiciones clave, y lee los análisis del resultado.… |
tenderplan_find_tender_by_number | Encuentra licitaciones por su número de aviso (el número en zakupki.gov.ru o en la plataforma de trading) en cualquier lugar de la base de datos de Tenderplan. Úsalo… |
tenderplan_list_saved_filters | Lista los filtros de lista que el usuario actual guardó en Tenderplan (versión 2): por subconjunto (type 0 clave, 1 marca, 2 usuario, 3 bin, 4 solicitudes legales… |
tenderplan_list_comments | Lista todos los comentarios que tu firma escribió sobre una licitación. Devuelve comments con _id, text (texto plano o un objeto de texto enriquecido con blocks)… |
tenderplan_add_comment | Escribe un comentario sobre una licitación en nombre del usuario del token. Los colegas en la firma lo ven en Tenderplan, que tiene una notificación para nuevos… |
tenderplan_list_open_tasks | Lista las tareas abiertas en todas las licitaciones de tu firma. Devuelve tasks con _id, name, desc (notas), tenderId, assigneeId, dueAt… |
tenderplan_list_tender_tasks | Lista las tareas y secciones de una licitación, abiertas y cerradas. Devuelve tasks (_id, name, desc, assigneeId, dueAt, dueCompleteAt… |
tenderplan_add_task | Agrega una tarea a una licitación, opcionalmente con un asignado, una fecha de vencimiento y un recordatorio. Devuelve la tarea almacenada con su _id, createdBy y… |
tenderplan_complete_task | Cierra una tarea de una licitación, o reabre una cerrada. Devuelve la tarea con dueCompleteAt establecido cuando se cierra. Necesita el tasks:write… |
tenderplan_search_organizations | Busca las organizaciones que Tenderplan conoce como clientes (compradores) y proveedores (participantes), por nombre o por INN. Usa el id de la organización de… |
tenderplan_get_organization | Lee la tarjeta de una organización (cliente o proveedor) por su id de organización de Tenderplan: lo que Tenderplan tiene sobre esa entidad legal.… |
tenderplan_get_organization_egrul | Lee datos de una organización del registro estatal ruso de entidades legales (ЕГРЮЛ, EGRUL): sus sucursales, oficinas representativas… |
tenderplan_get_organization_contacts | Lee los contactos de una organización tal como Tenderplan los recopiló de sus licitaciones. Esto puede incluir datos personales de personas de contacto: usa… |
tenderplan_list_rnp_records | Lista las entradas de un proveedor en el registro de proveedores no confiables (РНП, versión 2). Cada entrada tiene _id, id (número de registro)… |
tenderplan_list_notifications | Lista las notificaciones del usuario actual como modelos cortos de licitaciones (versión 2): tenders con las licitaciones sobre las que son las notificaciones. Filtra por… |
tenderplan_list_calendar_events | Lista los eventos del calendario de licitaciones de la firma en una ventana de tiempo (versión 2): los eventos fechados de las licitaciones que tu firma monitorea. Ambos extremos… |
tenderplan_list_reference_values | Lee una de las listas de referencia de Tenderplan para traducir los ids numéricos en licitaciones y filtros: estados (9 filas: _id, name… |
tenderplan_add_tender_marks | Coloca una o más marcas (etiquetas) en una licitación, manteniendo las marcas que ya tiene. Tenderplan tiene una notificación para licitaciones marcadas, así que… |
tenderplan_mark_tenders_read | Marca las licitaciones como leídas para el usuario del token, de la manera en que se abren en Tenderplan. Hasta 100 licitaciones por llamada. La respuesta no está descrita… |
tenderplan_remove_tender_marks | Quita marcas (etiquetas) de una licitación. Instalado desactivado: quitar una marca elimina la licitación de la lista de esa etiqueta para toda la firma. La… |
Ejemplos de indicaciones
- "¿Qué nuevas licitaciones encontró mi clave Медицинское оборудование esta semana, con el precio máximo?"
- "Muestra la licitación 0373100012325000123 con sus protocolos y contratos."
- "Verifica al proveedor con INN 7701234567 en el registro de proveedores no confiables."
- "Agrega el comentario: prepara la solicitud para el viernes, a esa licitación."
- "¿Qué tareas están abiertas para mí, y qué plazos de licitación están en el calendario la próxima semana?"
Preguntas frecuentes
¿De dónde proviene el token? En Tenderplan abre la configuración de tu perfil, pestaña Интеграции с сервисами, bloque Тендерплан API, haz clic en Настроить, nombra el token, marca los permisos que necesitan las herramientas y haz clic en Сгенерировать токен. Tu rol en Tenderplan debe tener permitido agregar acceso a la API; si falta el bloque, pregunta al administrador de tu empresa.
¿Qué cubre? Licitaciones encontradas por tus claves y marcas guardadas, datos completos de licitaciones con protocolos, contratos, explicaciones, quejas y garantías bancarias, búsqueda en toda la base de datos con análisis, comentarios, tareas, organizaciones con datos de EGRUL y contactos, el registro de proveedores no confiables, notificaciones y el calendario de licitaciones. Pedidos, facturas, compras de tarifas, edición de claves y marcas, administración de usuarios y cargas de archivos no están incluidos; ninguna herramienta mueve dinero.
¿Qué herramientas se instalan desactivadas? tenderplan_remove_tender_marks, que quita etiquetas de las licitaciones. Actívalo en la página del conector solo si la IA debe usarlo. Para una configuración de solo lectura, crea el token sin los dos permisos de escritura.
¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.
Próximos pasos
¿Te ha sido útil esta guía?