Connect your assistant

The Wallyn MCP server address is:

Server URL

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

The transport is Streamable HTTP and authentication is OAuth 2.1 with PKCE. You do not paste a password or key: the client opens the Wallyn sign-in page and you click Allow.

Claude

1. Open Settings → Connectors in Claude (web or desktop).
2. Choose Add custom connector.
3. Enter the name Wallyn and the URL https://mcp.wallyn.com.br/mcp.
4. Sign in with your Wallyn account and click Allow.

In Claude Code, use the command line:

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

Then, inside Claude Code, run /mcp and choose wallyn to authenticate.

ChatGPT

1. Open Settings → Connectors and turn on developer mode if asked.
2. Create a new connector (MCP server) with the URL https://mcp.wallyn.com.br/mcp.
3. Choose OAuth as authentication and finish signing in to Wallyn.

For plugin-based tools, the equivalent file is:

mcp.json

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

Cursor

Create or edit .cursor/mcp.json in the project (or ~/.cursor/mcp.json for all projects):

.cursor/mcp.json

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

Open Settings → MCP, click Connect next to wallyn and authorize in the browser.

Gemini CLI

Edit ~/.gemini/settings.json:

~/.gemini/settings.json

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

In Gemini CLI, run /mcp auth wallyn to sign in.

Other clients

If your client only speaks stdio, use the mcp-remote bridge:

Generic configuration (stdio)

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

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

Test the connection

After authorizing, ask something simple:

“What is the balance of my bank accounts?”

The assistant should call list_bank_accounts and get_bank_account_balances and answer with each account’s balance in reais.

Multiple accounts (workspaces)

If you have access to more than one Wallyn account, the assistant can pass workspaceId to any tool to act on the right one. Ask it to call get_me first.

Disconnect

Remove the connector in your assistant’s settings at any time. Without the token, the assistant loses access.

Common problems

Symptom	What to do
401 or “invalid token”	The token expired or was revoked. Re-authenticate the connector.
The client does not open the sign-in	Confirm the client supports OAuth with dynamic registration; otherwise use the mcp-remote bridge.
The assistant does not see your accounts	You may be on the wrong account. Ask for get_me and pass the workspaceId.

Support

Still stuck? Write to atendimento@wallyn.com.br or contact support through the app.