⚡ DOCUMENTAÇÃO PARA DESENVOLVEDORES & REVENDEDORES

Manual de Integração: API REST & Servidor MCP

Conecte seus agentes autônomos de Inteligência Artificial (Cursor, Claude Desktop, Antigravity, n8n, LangChain, Flowise e bots do WhatsApp/Telegram) para cadastrar clientes, ativar licenças e sincronizar listas M3U automaticamente na nuvem.

💼 Plano de Assinatura para Desenvolvedor & Revendedor

R$ 100,00 / MÊS

Com a assinatura mensal de R$ 100, você recebe sua Chave de API Bearer com permissão de chamadas ilimitadas, servidor MCP dedicado e suporte prioritário.

CHAVE PIX OFICIAL PARA ASSINATURA

Faça o Pix de R$ 100,00 e envie o comprovante para tons217@gmail.com. Sua chave de acesso será enviada em instantes.

MCP 1. Servidor MCP (Model Context Protocol)

O Model Context Protocol (MCP) é o protocolo padrão que permite que IAs executem ferramentas no mundo real. Com o servidor MCP do IPTV da Casa, a IA lê fotos enviadas por clientes no WhatsApp ou comandos no chat e cadastra a TV sozinha.

Configuração no Claude Desktop ou Cursor:

Adicione este bloco no seu arquivo claude_desktop_config.json:

{
  "mcpServers": {
    "iptvdacasa": {
      "command": "node",
      "args": ["c:/Users/Ton/Documents/iptvdacasa/mcp_server/index.js"],
      "env": {
        "IPTV_API_URL": "https://iptvdacasa.pages.dev/api/ai",
        "IPTV_API_KEY": "iptv_live_SEU_TOKEN_AQUI"
      }
    }
  }
}

Ferramentas MCP Disponíveis para a IA:

Nome da Ferramenta	Parâmetros	O que ela faz
`iptv_cadastrar_cliente`	`mac`, `key`, `clientName`, `days`, `playlistUrl`	Registra a Smart TV do cliente na nuvem e concede a quantidade de dias contratada.
`iptv_adicionar_lista_m3u`	`mac`, `playlistUrl`, `playlistName`	Sincroniza a URL da lista M3U para a TV do cliente instantaneamente.
`iptv_consultar_cliente`	`mac`	Retorna se a TV está ativa, data de expiração e qual lista está vinculada.

POST 2. Endpoints da API REST JSON

/api/ai

Endpoint unificado para integrações via HTTP (Python, Node.js, PHP, cURL, webhooks do n8n ou Zapier).

Exemplo 1: Cadastrar e Ativar Smart TV do Cliente

curl -X POST https://iptvdacasa.pages.dev/api/ai \
  -H "Authorization: Bearer iptv_live_SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "register_device",
    "mac": "00:1A:79:B4:C2:10",
    "key": "684920",
    "playlistName": "TV da Sala - Cliente Carlos",
    "days": 365,
    "playlistUrl": "https://meuservidor.com/get.php?username=carlos&password=123"
  }'

Exemplo 2: Adicionar ou Substituir Lista M3U

curl -X POST https://iptvdacasa.pages.dev/api/ai \
  -H "Authorization: Bearer iptv_live_SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "upload_m3u",
    "mac": "00:1A:79:B4:C2:10",
    "playlistName": "Lista Premium 4K",
    "playlistUrl": "https://meuservidor.com/get.php?username=carlos&password=123"
  }'

Exemplo 3: Integração em Python (requests)

import requests

url = "https://iptvdacasa.pages.dev/api/ai"
headers = {
    "Authorization": "Bearer iptv_live_SEU_TOKEN",
    "Content-Type": "application/json"
}

# Cadastrar e subir lista para o cliente
payload = {
    "action": "register_device",
    "mac": "00:1A:79:B4:C2:10",
    "key": "684920",
    "playlistName": "Cliente VIP",
    "playlistUrl": "https://servidor.com/lista.m3u",
    "days": 365
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())