Conecte o seu assistente de IA
Conecte o Claude, o ChatGPT ou outro cliente MCP ao seu portal do cliente. O assistente pode ler seus projetos, faturas, tickets de suporte, status do site e arquivos. Nos planos Pro e Ultra, ele também pode abrir tickets ou enviar pedidos de alteração, mas somente depois que você confirmar a prévia exata.
Ferramentas e limites
Cada plano define seus próprios limites. O servidor aplica o número de chaves, as requisições por minuto por chave e as unidades mensais de toda a conta.
Basic
GratuitoSomente leitura. Sem gravações neste plano
Consultar projetos, faturas, tíquetes de suporte, status do site, arquivos do projeto e o relatório mensal.
Pro
3,000,000 Toman / mêsLeitura e gravações confirmadas
Todas as ferramentas de leitura, além de gravações confirmadas: abrir e responder tickets de suporte, enviar pedidos de alteração e mensagens do Farr, enviar arquivos, criar e atualizar rascunhos de conteúdo, e aceitar ou recusar propostas. Cada gravação é exibida em prévia primeiro e só é aplicada depois que você aprova.
Ultra
5,000,000 Toman / mêsTudo do Pro, além de ações em massa e webhooks
Tudo do Pro, além de ações em massa em tickets (bulk_ticket_reply, bulk_ticket_close e bulk_actions, até 20 tickets por chamada), webhooks (webhook_list, webhook_create e webhook_delete) e relatórios mensais agendados (scheduled_reports e scheduled_reports_get).
Segurança: sem ações de pagamento ou propriedade
A API do assistente não possui ferramentas para pagar faturas, transferir fundos, alterar a titularidade da conta ou criar e revogar chaves. As faturas são somente para leitura. O pagamento é realizado por você no portal do cliente.
Como criar uma chave de assistente
Crie uma chave no portal do cliente em três etapas.
1. Iniciar sessão no portal
Acesse o portal do cliente e abra Acesso do assistente no menu.
2. Criar uma chave
Clique em "Criar chave". Insira um nome de 3 a 60 caracteres (por exemplo, "Claude Code - portátil"), escolha as permissões e a validade. A criação solicitará uma nova autenticação.
3. Copiar a chave uma única vez
A chave completa só é exibida uma vez, imediatamente após a sua criação. O servidor guarda apenas um hash SHA-256 da parte secreta. Se a perder, revogue-a e crie uma nova.
Como conectar Claude e ChatGPT
Conecte-se através do transporte MCP Streamable HTTP, usando uma chave Bearer ou autenticando-se via OAuth.
Claude Code e outros clientes MCP
Em ferramentas que aceitam URL de servidor e cabeçalhos, como o ficheiro .mcp.json do Claude Code, adicione esta entrada substituindo a variável pela sua chave:
{
"mcpServers": {
"sajjad-portal": {
"type": "http",
"url": "https://sajjad.blog/api/client/mcp",
"headers": {
"Authorization": "Bearer <YOUR_AGENT_KEY>"
}
}
}
}ChatGPT e assistentes Web
Adicione este endereço como conector personalizado e autentique-se quando solicitado (OAuth). Nenhuma chave é necessária neste método. Os nomes dos menus podem variar conforme o assistente.
O que significa "Pré-visualizar e confirmar" para operações de escrita
Uma alteração nunca é aplicada na primeira chamada.
Quando um assistente chama uma ferramenta de escrita, o servidor armazena a solicitação exata e retorna uma pré-visualização com um token de confirmação de uso único válido por 10 minutos. A alteração só é aplicada quando o assistente invoca a ferramenta de confirmação com esse token após o seu consentimento. Cada token funciona apenas uma vez, para a chave e a conta emissoras e com os mesmos argumentos. Cada ação preparada é registada.
Referência de ferramentas verificadas
As principais ferramentas que o endpoint do cliente oferece, além da ferramenta de confirmação usada depois de uma prévia. Uma ferramenta fora do seu plano é recusada com uma mensagem plan_required.
| Nome da ferramenta | Tipo de acesso | Descrição da funcionalidade |
|---|---|---|
| projects_list | Leitura | Listar até 50 dos seus projetos: código, nome, status, progresso e data de conclusão. |
| invoices_list | Leitura | Listar até 25 faturas com data de vencimento, total, valor pago, saldo e status. Defina openOnly para ver apenas as pendentes. Rascunhos e links de pagamento estão excluídos. |
| tickets_list | Leitura | Listar até 50 dos seus tíquetes de suporte com status, prioridade e hora da última resposta. |
| ticket_get | Leitura | Obter o histórico de mensagens de um tíquete de suporte (até 100 mensagens). Notas internas são excluídas. |
| ticket_create | Escrita confirmada | Preparar um novo tíquete de suporte com prioridade baixa ou normal. Só é criado após a confirmação da pré-visualização. |
| ticket_reply | Escrita confirmada | Preparar uma resposta para um tíquete aberto. Tíquetes encerrados não aceitam respostas. Enviada apenas após confirmação. |
| change_request_create | Escrita confirmada | Preparar uma solicitação de alteração para um dos seus projetos. Aplicada somente após confirmação da pré-visualização. |
| site_status | Leitura | Mostrar status do domínio, visitantes e visualizações de página (24 horas e 7 dias), disponibilidade percentual e erros pendentes do site conectado. Dados da última sincronização de telemetria. |
| files_list | Leitura | Listar ficheiros no armazenamento do projeto, até 100 por página, opcionalmente dentro de uma pasta. |
| file_link | Leitura | Criar um link de transferência para um ficheiro armazenado. O link expira após 15 minutos. |
| report_monthly | Leitura | Obter o resumo mensal (até 12 meses anteriores): projetos, tíquetes abertos e fechados, estado atual do site, faturas pendentes e um link de PDF válido por 15 minutos. |
Perguntas frequentes
Dúvidas comuns sobre assistentes de clientes, segurança e limites de utilização.
O meu assistente de IA pode pagar faturas automaticamente?
Não. A API do assistente não inclui ferramentas para pagar faturas ou transferir fundos. As faturas são apenas para consulta e o pagamento é realizado diretamente no portal do cliente.
O que acontece quando atinjo a minha quota mensal de unidades?
Cada plano tem um orçamento mensal de unidades para toda a conta. Uma leitura custa 1 unidade e uma prévia de gravação custa 3. Quando o uso da conta no mês chega ao orçamento do plano, as chamadas seguintes retornam um erro quota_exceeded dentro do resultado da ferramenta (HTTP 200, não 429) até que o mês do calendário UTC mude.
Como revogo uma chave de assistente em caso de comprometimento?
Abra Acesso do assistente no portal do cliente, selecione Revogar chave e confirme. Qualquer solicitação posterior com essa chave será rejeitada de imediato. Assistentes conectados via OAuth podem ser desconectados na mesma página.
É necessário executar uma ponte local para conectar o ChatGPT?
Não. O endpoint é um endereço HTTPS padrão: o cliente envia mensagens JSON-RPC via POST e recebe JSON. Os assistentes em nuvem conectam-se diretamente sem qualquer software local.
Pronto para colocar o seu assistente a trabalhar?
Escolha um plano para começar ou aceda ao portal do cliente e crie uma chave de assistente.