MCP API Documentation – SiteSmart Framework

🔑 Autenticación / Authentication / Autenticação

ES: Cada empresa creada recibe una ApiKeyGenerada única. EN: Each company created gets a unique ApiKeyGenerada. PT: Cada empresa criada recebe uma ApiKeyGenerada exclusiva.

Tipo / Type	Descripción / Description / Descrição	Ejemplo
Clave Maestra / Master Key	ES: Usada sólo para crear nuevas empresas. EN: Used only for registering new companies. PT: Usada apenas para registrar novas empresas.	`x-api-key: [email protected]`
ApiKeyGenerada	ES: Clave asignada automáticamente por el sistema, específica por empresa. EN: Automatically assigned per company, used for all future API calls. PT: Atribuída automaticamente, usada em todas as chamadas futuras da API.	`x-api-key: mcp_41cf2ec156fa4c4f8b28!`

🚀 Flujo Completo de Ejemplo / Full Flow Example / Fluxo Completo

1️⃣ Crear Empresa / Create Company / Criar Empresa

curl --location 'https://mcp.sitesmart-app.com/m/McpExec_CreateEmpresa.aspx' \
--header 'x-api-key: [email protected]' \
--header 'Content-Type: application/json' \
--data '{
  "Empresa": "SiteSmart",
  "Proyecto": "MDS",
  "Usuario": "Antonio",
  "Email": "[email protected]"
}'

Respuesta / Response:

{
  "ok": true,
  "resultado": [
    {
      "IdEmpresa": "4a8d815e-e2df-4ecd-80b6-d3f328777d18",
      "Empresa": "SiteSmart",
      "Proyecto": "MDS",
      "Token": "579062cca5",
      "Esquema": "MCP_4A8D815EE2DF4ECD80B6D3F328777D18",
      "ApiKeyGenerada": "mcp_41cf2ec156fa4c4f8b28!"
    }
  ]
}

ES: Usa la ApiKeyGenerada en todos los siguientes endpoints.
EN: Use the ApiKeyGenerada for all future endpoints.
PT: Use a ApiKeyGenerada para todos os próximos endpoints.

2️⃣ Crear una Tabla / Create Table / Criar Tabela

curl --location 'https://mcp.sitesmart-app.com/m/McpExec_SystemExec.aspx' \
--header 'x-api-key: mcp_41cf2ec156fa4c4f8b28!' \
--header 'Content-Type: application/json' \
--data '{
  "Empresa": "SiteSmart",
  "Proyecto": "MDS",
  "Usuario": "Antonio",
  "Esquema": "MCP_4A8D815EE2DF4ECD80B6D3F328777D18",
  "ModoSistema": true,
  "SQL": "CREATE TABLE MCP_4A8D815EE2DF4ECD80B6D3F328777D18.ClientesGPT (Id INT IDENTITY(1,1), Nombre NVARCHAR(100), Fecha DATETIME)"
}'

{
  "ok": true,
  "mensaje": "Tabla creada correctamente."
}

3️⃣ Insertar Datos / Insert Data / Inserir Dados

curl --location 'https://mcp.sitesmart-app.com/m/McpExec_AIManager.aspx' \
--header 'x-api-key: mcp_41cf2ec156fa4c4f8b28!' \
--header 'Content-Type: application/json' \
--data '{
  "Empresa": "SiteSmart",
  "Proyecto": "MDS",
  "Usuario": "Antonio",
  "Esquema": "MCP_4A8D815EE2DF4ECD80B6D3F328777D18",
  "SQL": "INSERT INTO MCP_4A8D815EE2DF4ECD80B6D3F328777D18.ClientesGPT (Nombre, Fecha) VALUES ('Juan Perez', GETDATE())"
}'

{
  "ok": true,
  "mensaje": "1 fila insertada correctamente."
}

4️⃣ Consultar Datos / Query Data / Consultar Dados

curl --location 'https://mcp.sitesmart-app.com/m/McpExec_AIManager.aspx' \
--header 'x-api-key: mcp_41cf2ec156fa4c4f8b28!' \
--header 'Content-Type: application/json' \
--data '{
  "Empresa": "SiteSmart",
  "Proyecto": "MDS",
  "Usuario": "Antonio",
  "Esquema": "MCP_4A8D815EE2DF4ECD80B6D3F328777D18",
  "prompt": "muéstrame los nombres de los clientes"
}'

{
  "ok": true,
  "filas": 1,
  "resultado": [
    {"Id": 1, "Nombre": "Juan Perez", "Fecha": "2025-11-04T12:44:00Z"}
  ]
}

5️⃣ Analytics / Reporte de Ventas

curl --location 'https://mcp.sitesmart-app.com/m/McpExec_Analytics.aspx' \
--header 'x-api-key: mcp_41cf2ec156fa4c4f8b28!' \
--header 'Content-Type: application/json' \
--data '{
  "Empresa": "SiteSmart",
  "Proyecto": "MDS",
  "Usuario": "Antonio",
  "Consulta": "KPI_Ventas_Mensuales"
}'

{
  "ok": true,
  "resultado": [
    {"Mes": "Enero", "Ventas": 12000},
    {"Mes": "Febrero", "Ventas": 9800}
  ]
}

6️⃣ Estado del Sistema / System State / Estado do Sistema

curl --location 'https://mcp.sitesmart-app.com/m/McpExec_AIState.aspx' \
--header 'x-api-key: mcp_41cf2ec156fa4c4f8b28!'

{
  "ok": true,
  "estado": "operativo",
  "ultima_ejecucion": "2025-11-04T18:32:01Z",
  "latencia_promedio_ms": 1500,
  "consultas_hoy": 120
}

🧩 Códigos de Estado / Status Codes / Códigos de Status

Código	Significado (ES / EN / PT)
200	Éxito / Success / Sucesso
400	Error en la solicitud / Bad Request / Requisição Inválida
403	Acceso denegado / Forbidden / Acesso Negado
500	Error interno / Internal Error / Erro Interno

💡 Buenas Prácticas / Best Practices / Boas Práticas

ES: Usa la ApiKeyGenerada para todas las llamadas después de crear la empresa.
EN: Always use the ApiKeyGenerada for all subsequent API calls.
PT: Sempre use a ApiKeyGenerada para todas as chamadas subsequentes.
No uses DROP, MERGE o TRUNCATE.
Incluye siempre el campo Esquema en tus consultas.
Verifica las tablas con SELECT * FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA='MCP_XXXX'.
Todos los eventos quedan registrados en MCP_LogIA.