# Connect an AI assistant to Aurio

[Español](./mcp.es.md)

To try Aurio without signing in, add `https://www.aurioapp.com/api/mcp/calculadoras` as a remote HTTP MCP server and ask for a mortgage estimate using fictional amounts. To ask about your records, use `https://www.aurioapp.com/api/mcp/cuenta` with OAuth and select an Aurio Premium workspace on the consent screen. Try “Use Aurio to compare my monthly income and expenses.” Revoke the connection in Aurio’s Security settings whenever you choose.

## Connection options

Status on 17 November 2026. A client may require a paid plan or administrator approval to add a server.

| Client                 | Where to add Aurio                                                                                                                                                                                                                   | Account access                                                                                     |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------- |
| ChatGPT                | Select Aurio if available in Apps, or add the account endpoint as a custom MCP app in developer mode.                                                                                                                                | OpenAI approved Aurio. Public listing and scanner reconnection await verification.                 |
| Claude                 | Settings → Connectors → Add custom connector. [Aurio setup guide](./claude.md)                                                                                                                                                       | Custom connection available. Directory listing under review.                                       |
| Grok                   | Open Connectors, add a custom MCP server and enter the endpoint. [Grok guide](https://docs.x.ai/grok/connectors)                                                                                                                     | Sign-up and connection verified on grok.com (17 Nov 2026). Read-only access.                       |
| Perplexity             | Add a custom remote connector, paste the endpoint and select OAuth for account access. [Perplexity guide](https://www.perplexity.ai/changelog/what-we-shipped---march-13-2026)                                                       | Read-only account queries. Callback implemented in Aurio. A live sign-in still needs verification. |
| Cursor                 | Add a remote HTTP MCP server at `https://www.aurioapp.com/api/mcp/cuenta`, then complete OAuth in the browser.                                                                                                                       | Read-only account access.                                                                          |
| VS Code with Copilot   | Choose Add Server → HTTP, use `https://www.aurioapp.com/api/mcp/cuenta`, then complete OAuth in the browser. [VS Code guide](https://code.visualstudio.com/docs/agent-customization/mcp-servers)                                     | Read-only account access.                                                                          |
| Claude Code            | Add `https://www.aurioapp.com/api/mcp/cuenta` as a remote HTTP MCP server and complete OAuth in the browser.                                                                                                                         | Read-only account access.                                                                          |
| Codex CLI              | Add `https://www.aurioapp.com/api/mcp/cuenta` as a remote HTTP MCP server and complete OAuth in the browser.                                                                                                                         | Read-only account access.                                                                          |
| Gemini CLI             | Set the server’s `httpUrl` to `https://www.aurioapp.com/api/mcp/cuenta`; use `/mcp auth aurio` and complete OAuth in the browser. [Gemini CLI guide](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md) | Read-only account access.                                                                          |
| Other HTTP MCP clients | Use `https://www.aurioapp.com/api/mcp/cuenta` as the remote server URL and complete OAuth in the browser.                                                                                                                            | Read-only when the client supplies an allowed callback.                                            |
| Gemini Apps            | Google offers custom apps and a separate developer mode. [Google guide](https://developers.google.com/connected-apps/mcp/dev-mode/usage)                                                                                             | Account OAuth has not been verified in Gemini Apps. Gemini CLI setup applies only to the CLI.      |

For Grok, Aurio recognizes the exact return URL `https://grok.com/connectors-oauth-exchange-code/` and `https://console.x.ai/connectors-oauth-exchange-code/`. For Perplexity it recognizes `https://www.perplexity.ai/rest/connections/oauth_callback`. Enter the **Aurio MCP endpoint** in the client’s server URL field. The client supplies its own return URL.

Desktop account OAuth is enabled by default; `AURIO_MCP_DESKTOP_ENABLED=0` is the operator kill switch. The client must support dynamic registration, PKCE and an allowed IDE or loopback callback. Live account compatibility still needs verification for each client.

## Recording a purchase

On an enabled Claude or ChatGPT connection, ask “Prepare a €12.50 grocery purchase for review.” Open the review link, check the account, date and amount, then confirm in Aurio to save the record. Grok, Perplexity and generic desktop connections are limited to financial summaries. For a statement or receipt, use Aurio’s own upload screen.
