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

1. Clonar el repositorio

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

2. Instalar dependencias

npm install

3. Instalar el paquete globalmente

npm install -g .

4. Instalar el complemento en Cursor

node install-cursor-plugin.js

5. Reiniciar cursor

Alternativa: Configuración manual en Cursor

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

1. 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

2. Agregue la siguiente entrada al objeto "mcpServers":

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

3. 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

1. Cursor de lanzamiento

2. Abra la paleta de comandos (Cmd+P en macOS o Ctrl+P en Windows/Linux)

3. Busca "Keitaro" y selecciónalo.

4. 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