Conector de IA

Claude na web, no computador e no celular

1. Abra Personalizar → Conectores → Adicionar conector personalizado.
2. Cole o endereço do conector e clique em Conectar.
3. Entre com a sua conta do Singular, confira a conta mostrada e clique em Permitir acesso.

Em planos Team e Enterprise, quem adiciona o conector é o Owner da organização.

Claude Code

claude mcp add --transport http singular https://api.linksingular.com/v1/mcp

Rode o comando no terminal, abra o Claude Code, digite /mcp, escolha singular e autorize no navegador.

Com chave de API

Crie a chave em Configurações → Integrações → Assistentes de IA. Ela aparece uma vez só. Nos exemplos abaixo, troque SUA_CHAVE pela chave ou exporte SINGULAR_API_KEY.

Codex

# ~/.codex/config.toml
[mcp_servers.singular]
url = "https://api.linksingular.com/v1/mcp"
bearer_token_env_var = "SINGULAR_API_KEY"

Cursor

{
  "mcpServers": {
    "singular": {
      "url": "https://api.linksingular.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer SUA_CHAVE"
      }
    }
  }
}

Outros assistentes

Cadastre o endereço como servidor MCP por HTTP. Se o assistente aceitar OAuth, o login acontece no navegador. Se não aceitar, mande a chave no cabeçalho Authorization: Bearer.

• PostOn: contas, posts, agenda e publicação nas redes sociais.
• Produtos e estoque: cadastro, categorias, consulta de estoque e saída avulsa.
• Clientes: busca, cadastro, endereço e etiquetas.
• Pedidos: criação, confirmação, geração da cobrança, baixa manual e registro de estorno.
• Compras: fornecedores, pedidos de compra, envios e recebimento.
• Loja: catálogo, pedidos da loja, venda manual, fotos e destaques.

O assistente só vê o que a sua conta tem: depende dos módulos contratados e das suas permissões.

• Não acessa prontuário, diário, documentos nem agenda.
• Não transfere dinheiro. Estorno em provedor de pagamento, compra de etiqueta e cancelamento de pedido online ficam no painel.
• Pode gerar a cobrança de um pedido, com o link para o seu cliente pagar. Em cartão parcelado, as parcelas seguintes são cobradas no cartão do cliente, como em qualquer cobrança feita pelo painel.

• O assistente age em seu nome e só faz o que você pode fazer na conta conectada.
• Antes de permitir, confira o endereço na tela. Se o Singular não conhecer o aplicativo, a tela avisa para onde vai o acesso e pede que você confirme que foi você quem pediu.
• As ações de escrita, os erros e os eventos de segurança ficam registrados.
• Para desconectar, use Configurações → Integrações → Assistentes de IA. A renovação para na hora, e o acesso já emitido vale por até 1 hora.
• Trocar ou redefinir a senha desconecta os seus assistentes e revoga as suas chaves pessoais.
• Quem tiver a sua chave age como você. Guarde-a como uma senha.

Observações de pedido, nomes e mensagens são escritos por clientes e podem conter instruções para enganar o assistente. Revise o que ele propõe antes de confirmar, principalmente publicações, baixas e mudanças de estoque.

• 120 chamadas por minuto por conexão ou chave, e 30 escritas por minuto.
• Uma ferramenta por requisição.
• A primeira chamada depois de um tempo parado pode levar cerca de 30 segundos. O assistente espera e repete sozinho.

O assistente pediu login de novo

A conexão vence depois de 90 dias sem uso, e trocar a senha também desconecta. Conecte de novo.

Uma ferramenta não aparece

Ela depende do módulo contratado e das suas permissões. Se a conexão foi aberta antes de uma novidade, reconecte.

O botão Permitir acesso está desligado

A sua conta não tem a permissão de gerenciar assistentes, ou falta confirmar que foi você quem pediu a conexão.

Para dúvidas ou para relatar um problema de segurança, escreva para contato@linksingular.com.