Complemento MCP de la API TDS de Keitaro

Descripción

Servidor MCP para integración con la API TDS de Keitaro, que proporciona herramientas para trabajar con campañas, transmisiones, ofertas y otras entidades de Keitaro.

Related MCP server: TeamRetro MCP Server

Instalación

Instalación del complemento en Cursor

Clonar el repositorio

git clone <repository-url> cd mcp-keitaro-tds

Instalar dependencias

npm install

Instalar el paquete globalmente

npm install -g .

Instalar el complemento en Cursor

node install-cursor-plugin.js

Reiniciar cursor

Alternativa: Configuración manual en Cursor

También puedes agregar manualmente el servidor Keitaro MCP a tu configuración de Cursor:

Abra el archivo de configuración de Cursor MCP:

# On macOS open ~/.cursor/mcp.json # On Windows notepad %USERPROFILE%\.cursor\mcp.json # On Linux nano ~/.cursor/mcp.json

Agregue la siguiente entrada al objeto "mcpServers":

"Keitaro": { "command": "mcp-keitaro-tds", "args": [] }

Guarde el archivo y reinicie Cursor

Configuración de la clave API

Cree un archivo .env en la raíz del proyecto con los siguientes parámetros:

KEITARO_API_URL=http://your-keitaro-domain.com/admin_api/v1 KEITARO_API_KEY=your-api-key

Uso en Cursor

Cursor de lanzamiento
Abra la paleta de comandos (Cmd+P en macOS o Ctrl+P en Windows/Linux)
Busca "Keitaro" y selecciónalo.
Ahora puedes usar la API de Keitaro a través de Cursor

Herramientas disponibles

Campañas

list_campaigns - obtener una lista de campañas
get_campaign - obtener información sobre una campaña específica
create_campaign - crea una nueva campaña
update_campaign - actualizar una campaña existente
delete_campaign - eliminar una campaña

Flujos de tráfico

list_streams : obtiene una lista de flujos de tráfico para una campaña
get_stream - obtener información sobre una secuencia específica

Fuentes de tráfico

list_traffic_sources - obtener una lista de fuentes de tráfico
get_traffic_source : obtener información sobre una fuente de tráfico específica

Ofertas

list_offers - obtener una lista de ofertas
get_offer - obtener información sobre una oferta específica

Clics y conversiones

list_clicks - obtener una lista de clics
get_click - obtener información sobre un clic específico
list_conversions - obtener una lista de conversiones
get_conversion - obtener información sobre una conversión específica

Informes

get_report - genera un informe con parámetros específicos

Dominios

list_domains - obtener una lista de dominios
get_domain - obtener información sobre un dominio específico

Ejemplos de uso

Obtener una lista de campañas

list_campaigns({ limit: 10, page: 1, search: "search query" })

Creando una nueva campaña

create_campaign({ name: "New Campaign", type: "position", cost_type: "CPC", cost_value: 1.5, group_id: 1, state: "active", traffic_source_id: 1 })

Obtener un informe

get_report({ from: "2025-01-01", to: "2025-01-31", group: "campaign", filters: { campaign_id: 123 } })

Desarrollo

Ejecutándose en modo de desarrollo

npm run dev

Probando el servidor MCP

npm run inspect

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Keitaro TDS API MCP Plugin