MCP

Usar WAMA com IA (MCP)

WAMA pode falar com ferramentas de IA populares através de MCP (Modelo Protocolo de Contexto). Após umas definições curta, pode perguntar ao assistente sobre produtos, stocks, vendas, fornecedores e compras para ** um ponto de venda** — o que escolhe quando se conecta.

** Endereço do servidor** (o mesmo para cada ferramenta):

https://mcp.wama.cloud/mcp

Duas maneiras de conectar

Iniciar sessão com o WAMA

1. Adicione o endereço do servidor acima na sua ferramenta IA.
2. Quando solicitado para um ID do cliente, digite: wama-mcp
3. Fazer login completo no navegador, escolher um ** ponto de venda**, e escolher ** ler** ou ** ler e escrever**.
4. Voltar para a ferramenta IA — o utilizador está conectado.

Pode revogar o acesso mais tarde na aplicação web: Definições → Integrações.

Colar uma chave de API

1. Na web WAMA: Definições → Integraçãos → Criar chave API.
2. Escolha o ponto de venda e escopo, em seguida ** copie a chave** (mostrado apenas uma vez).
3. Na ferramenta IA, adicione o mesmo endereço do servidor e coloque a chave no cabeçalho Autorização como:

Bearer wama_…your_key…

Mais detalhes: Integrations e o API guide.

Cursor

1. Abra Cursor Definições → MCP (ou edite seu ficheiro de definições MCP).
2. Adicionar um servidor chamado wama com URL https://mcp.wama.cloud/mcp.
3. Preferir o sign-in: set client id wama-mcp e escopo read (ou read write se necessário).
4. Aprovar o login do navegador, em seguida, tentar uma pergunta simples como “Lista alguns produtos”.

Definições do exemplo (sinal):

{
  "mcpServers": {
    "wama": {
      "url": "https://mcp.wama.cloud/mcp",
      "auth": {
        "CLIENT_ID": "wama-mcp",
        "scopes": ["read"]
      }
    }
  }
}

Alternativa de paste-key: use o mesmo URL e um cabeçalho Autorization com Bearer wama ....

Código Claude

Num terminal:

claude mcp add --transport http --client-id wama-mcp wama https://mcp.wama.cloud/mcp

Em seguida, execute claude mcp login wama (ou use /mcp no Código Claude) e termine o login do navegador.

Claude.ai

1. Abra definições Claude.ai para conectores / MCP personalizado.
2. Adicionar URL do servidor https://mcp.wama.cloud/mcp.
3. Se solicitado para um ID do cliente, use wama-mcp.
4. Complete o login e consentimento do navegador WAMA.

ChatGPT

1. Ligar Modo de desenvolvimento (ou conectores MCP / personalizados, dependendo do seu plano ChatGPT).
2. Adicionar um servidor MCP personalizado com URL https://mcp.wama.cloud/mcp.
3. Prefere o ID do cliente wama-mcp (sem segredo) quando a UI o permite.
4. Se o ChatGPT apenas oferece registo automático de cliente e falha, use paste uma chave API em vez disso.

Gemini

1. Abra Gemini Definições → Aplicações ligadas.
2. Escolha + Personalizado.
3. Introduza o URL do servidor MCP https://mcp.wama.cloud/mcp.
4. Abra Definições adicionais → Mostrar mais.
5. Definir ** ID do cliente** para wama-mcp e deixar ** Segredo do cliente** vazio.
6. Continue e complete o login e consentimento do navegador WAMA.

Gemini pode mostrar que o servidor não suporta registo automático — que é esperado; use o ID do cliente estático acima.

Código VS / Copiloto GitHub

1. Abrir definições MCP / Copilot MCP (JSON).
2. Adicionar um servidor HTTP apontando para https://mcp.wama.cloud/mcp com OAuth cliente id wama-mcp.
3. Complete o login do navegador quando solicitado.

Exemplo:

{
  "servers": {
    "wama": {
      "type": "http",
      "url": "https://mcp.wama.cloud/mcp",
      "oauth": {
        "clientId": "wama-mcp"
      }
    }
  }
}

Código OpenAI CLI

Adicionar um servidor MCP HTTP com URL https://mcp.wama.cloud/mcp e OAuth cliente id wama-mcp. Siga os documentos atuais do Codex para o ficheiro de definições exato. Completar o login do navegador quando solicitado.

Windsurf

Adicionar um servidor MCP remoto https://mcp.wama.cloud/mcp com ID cliente wama-mcp, em seguida, termine o login do navegador.

Outras ferramentas de IA

Se sua ferramenta suporta MCP remoto sobre HTTPS:

1. Usar URL https://mcp.wama.cloud/mcp.
2. ID do cliente wama-mcp (sem segredo) ao usar o login.
3. Ou cole uma chave API como Autorização: Bearer wama ....

Aplicações de ambiente de trabalho que abrem um URL de retorno de chamada local (http://localhost… ou http://127.0.0.1…) são suportadas automaticamente.

O que pode pedir

Com um assistente conectado (exemplos):

• “Produtos de pesquisa contendo …”
• “Lista de categorias” / “Categorias de pesquisa para …” / “Obter categoria …”
• “Criar um produto chamado …” / “Atualizar o preço do produto …”
• “Criar uma categoria …” / “ Renomear uma categoria …”
• “Qual é o stock para o produto …?”
• “Lista de locais neste armazém”
• “Fornecedores de listas” / “Atualizar o endereço do fornecedor …”
• “Criar um rascunho de encomenda de compra para …”
• “Dê-me um resumo de vendas para esta semana”

Ações de escrita (ajustar stock, criar ou atualizar um produto ou categoria, criar ou concluir uma venda, criar um rascunho de compra, atualizar um fornecedor) precisa de uma lead & write chave ou âmbito de consentimento. Prefira leitura até que precise deles.

Dicas de segurança

• Uma ligação = ** um ponto de venda**. Criar outra chave ou reconectar se precisar de um armazém / loja diferente.
• Tratar chaves API como palavra-passes. Não os partilhe em chat, e-mail ou tickets públicos.
• Revogar chaves não utilizadas em Definições → Integrações.
• Para desenvolvedores com base na API REST (não MCP), veja API guide.