API e MCP

1. Começar em 1 minuto

Entre como dono da Empresa em app.prospectar.io, abra Configurações → Integrações → Chaves de acesso e clique em Criar chave. Escolha se ela pode ler o Catálogo, o Funil ou os dois, e guarde a chave que começa com prospectar_ (ela aparece só nessa hora).

Depois mande a chave no cabeçalho de uma chamada:

curl "https://api.prospectar.io/v1/catalog/items" \
  -H "Authorization: Bearer prospectar_a1b2c3d4e5f6..."

O preço vem como a Empresa escreveu em priceLabel, e também em centavos em priceInCents quando começa com um valor fixo (250000 é R$ 2.500,00):

{
  "data": [
    {
      "id": "6f1d2b7e-0000-4000-8000-000000000004",
      "name": "Plano Pro",
      "category": "Planos",
      "priceLabel": "R$ 2.500/mês",
      "priceInCents": 250000,
      "description": null,
      "durationMinutes": 45,
      "status": "available",
      "createdAt": "2026-10-19T00:00:00.000Z",
      "updatedAt": "2026-10-19T00:00:00.000Z"
    }
  ]
}

2. O que dá para ler (REST)

A base é https://api.prospectar.io/v1. Toda chamada leva Authorization: Bearer prospectar_...:

• GET /v1/catalog/items (escopo catalog:read): os planos, serviços e produtos da Empresa, com nome, grupo, preço como a Empresa escreveu (priceLabel), valor em centavos quando fixo (priceInCents), descrição, duração nas reuniões e status (available ou unavailable).
• GET /v1/crm/stages (escopo crm:read): as etapas do Funil em ordem, com nome, cor, posição e tipo (open, won ou lost), sem os contatos nem as conversas.

O contrato completo em OpenAPI 3.1 fica em https://api.prospectar.io/v1/openapi.json e pode ser aberto sem chave.

3. Conectar Claude, ChatGPT ou outro agente (MCP)

Adicione este endereço como conector MCP no seu assistente de IA:

https://api.prospectar.io/mcp

O assistente abre app.prospectar.io/conectar para o dono da Empresa confirmar. Ao clicar em Conectar, criamos uma chave comum para a Empresa aberta no app, com o nome do assistente (por exemplo Claude (claude.ai)), que lê o Catálogo e o Funil. Ferramentas que não abrem essa tela podem mandar Authorization: Bearer prospectar_... direto no cabeçalho.

O assistente recebe duas ferramentas, ambas só de leitura:

• list_catalog_items (Ler o Catálogo): devolve os mesmos itens de GET /v1/catalog/items.
• list_crm_stages (Ler as etapas do Funil): devolve as mesmas etapas de GET /v1/crm/stages.

4. Conectar um script ou terminal sem navegador

Em uma máquina sem navegador, peça um código de 8 letras com o client_id prospectar-agent. O dono abre app.prospectar.io/conectar/codigo, confere o código e aprova. O código vale por 10 minutos:

curl https://api.prospectar.io/oauth/device_authorization \
  -d client_id=prospectar-agent \
  -d resource=https://api.prospectar.io/mcp

# a cada 5 segundos, até você confirmar o código em app.prospectar.io/conectar/codigo
curl https://api.prospectar.io/oauth/token \
  -d client_id=prospectar-agent \
  -d grant_type=urn:ietf:params:oauth:grant-type:device_code \
  -d device_code=$DEVICE_CODE

5. Limites, erros e privacidade

• Quem cria e apaga: só o dono da Empresa, na própria conta. Cada Empresa pode ter até 10 chaves ativas ao mesmo tempo.
• Limite por minuto: cada chave faz até 100 chamadas por minuto. Passando disso, a resposta é 429 RATE_LIMITED com o cabeçalho Retry-After dizendo quantos segundos esperar.
• Desconectar na hora: apagar a chave em Configurações → Integrações → Chaves de acesso corta o acesso na próxima chamada. Se o dono sair da Empresa ou a Empresa for encerrada, a chave também para de valer na hora.
• Privacidade: como tratamos as chaves e os pedidos de conexão de apps de IA está na nossa Política de Privacidade.