Conectar o seu assistente

O endereço do servidor MCP do Wallyn é:

URL do servidor

https://mcp.wallyn.com.br/mcp

O transporte é Streamable HTTP e a autenticação é OAuth 2.1 com PKCE. Você não cola senha nem chave: o cliente abre a tela de login do Wallyn e você clica em Permitir.

Disponibilidade

Em breve O login OAuth em produção ainda não foi liberado. Os exemplos abaixo mostram a configuração prevista.

Claude

1. Abra Configurações → Conectores no Claude (web ou desktop).
2. Escolha Adicionar conector personalizado.
3. Informe o nome Wallyn e a URL https://mcp.wallyn.com.br/mcp.
4. Entre com a sua conta Wallyn e clique em Permitir.

No Claude Code, use a linha de comando:

claude mcp add --transport http wallyn https://mcp.wallyn.com.br/mcp

Depois, dentro do Claude Code, rode /mcp e escolha wallyn para autenticar.

ChatGPT

1. Abra Configurações → Conectores e ative o modo desenvolvedor, se for pedido.
2. Crie um novo conector (servidor MCP) com a URL https://mcp.wallyn.com.br/mcp.
3. Escolha OAuth como autenticação e conclua o login no Wallyn.

Em ferramentas baseadas em plugin, o arquivo equivalente é:

mcp.json

{
  "mcpServers": {
    "wallyn": {
      "type": "streamable-http",
      "url": "https://mcp.wallyn.com.br/mcp"
    }
  }
}

Cursor

Crie ou edite .cursor/mcp.json no projeto (ou ~/.cursor/mcp.json para todos os projetos):

.cursor/mcp.json

{
  "mcpServers": {
    "wallyn": {
      "url": "https://mcp.wallyn.com.br/mcp"
    }
  }
}

Abra Settings → MCP, clique em Connect ao lado de wallyn e autorize no navegador.

Gemini CLI

Edite ~/.gemini/settings.json:

~/.gemini/settings.json

{
  "mcpServers": {
    "wallyn": {
      "httpUrl": "https://mcp.wallyn.com.br/mcp"
    }
  }
}

No Gemini CLI, rode /mcp auth wallyn para fazer o login.

Outros clientes

Se o seu cliente só fala stdio, use a ponte mcp-remote:

Configuração genérica (stdio)

{
  "mcpServers": {
    "wallyn": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.wallyn.com.br/mcp"]
    }
  }
}

No Windows, use "command": "cmd" e "args": ["/c", "npx", "-y", "mcp-remote", "https://mcp.wallyn.com.br/mcp"].

Testar a conexão

Depois de autorizar, peça algo simples:

“Qual o saldo das minhas contas bancárias?”

O assistente deve chamar list_bank_accounts e get_bank_account_balances e responder com o saldo de cada conta em reais.

Várias contas (workspaces)

Se você tem acesso a mais de uma conta no Wallyn, o assistente pode informar o workspaceId em qualquer ferramenta para agir na conta certa. Peça a ele para consultar get_me primeiro.

Desconectar

Remova o conector nas configurações do seu assistente a qualquer momento. Sem o token, o assistente deixa de ter acesso.

Problemas comuns

Sintoma	O que fazer
401 ou “token inválido”	O token expirou ou foi revogado. Reautentique o conector.
O cliente não abre o login	Confirme que o cliente suporta OAuth com registro dinâmico; senão, use a ponte mcp-remote.
O assistente não vê suas contas	Você pode estar na conta errada. Peça get_me e informe o workspaceId.