# Developer connectors Connect your AI coding agent to Airwallex documentation and sandbox The Airwallex developer connectors connects AI coding agents — Cursor, Claude Code, Codex, and similar tools — to Airwallex documentation and the Airwallex sandbox. Use it while you build and test an integration so your agent writes more accurate Airwallex code and can exercise the sandbox without leaving your editor. The toolkit provides two MCP servers: | Connector | Environment | Best for | Authentication | | --------------------------------------- | ----------------------- | ---------------------------------------------------------- | -------------- | | [Developer MCP](#install-developer-mcp) | Sandbox | Coding agents writing or testing integrations | OAuth | | [Docs MCP](#install-docs-mcp) | Read-only documentation | Any agent that needs Airwallex knowledge but no API access | None | > **\[INFORMATIONAL]** > > Looking to act on your **production** account — reading balances, creating beneficiaries, running multi-step workflows? That's [Airwallex AgentOS](https://www.airwallex.com/docs/developer-tools/ai/agentos.md), which is built for operators rather than integration development. The toolkit also includes the `airwallex-dev` skill plugin, which generates Airwallex integration code directly in your project. See [Developer integration skills](#developer-integration-skills). ## Developer MCP vs. Docs MCP - Use **Docs MCP** when your agent only needs to look up Airwallex documentation and API references. It requires no authentication and is safe to add to any agent. - Use **Developer MCP** when you also want the agent to create test resources, simulate events, and call sandbox endpoints. It includes everything Docs MCP does, plus sandbox tools. ## Benefits - **Faster information retrieval**: Agents fetch documentation and API references directly in the coding environment, with access to your codebase for context. - **Reduced hallucination**: Connecting agents to current Airwallex documentation and API surfaces reduces the rate of incorrect or outdated code. - **Build and test in one place**: Create test resources, simulate events, and run sandbox reads through natural language prompts without context-switching. ## Limitations - **Model dependency**: Quality varies by model. Different AI assistants produce different results, and no model is perfect. - **Sandbox only**: The Developer MCP testing tools run in sandbox only. For production reads and writes, use the [Airwallex CLI](https://www.airwallex.com/docs/developer-tools/cli.md) or [Airwallex MCP](https://www.airwallex.com/docs/developer-tools/ai/agentos.md). - **Hallucination reduction, not elimination**: Generated code and recommendations must always be reviewed, validated, and tested before use in production. ## Install Developer MCP Developer MCP is the sandbox MCP server. It exposes documentation tools, sandbox simulation tools, and certain endpoints. ### Before you begin - A compatible AI assistant installed (Cursor, Claude Code, or other MCP-compatible tool). - Network access to `https://mcp.sandbox.airwallex.com/developer`. - A [sandbox account](https://www.sandbox.airwallex.com/signup/sandbox) if you want to use the remote endpoint. ### Cursor You can use one-click installation links or manual configuration. Documentation and sandbox tools at the remote endpoint. Cursor initiates OAuth to authenticate with Airwallex. ![Install Airwallex Developer MCP in Cursor](/docs/assets/developer-tools/cursor-mcp-install-dark.svg) Or manually add to your Cursor MCP settings: ```json { "mcpServers": { "airwallex-dev": { "type": "http", "url": "https://mcp.sandbox.airwallex.com/developer" } } } ``` ![Cursor OAuth consent page for Airwallex Developer MCP](https://www.airwallex.com/docs/assets/developer-tools/ai/mcp-oauth-cursor-consent-page.png?width=50%) ![Airwallex sandbox login page for OAuth authentication](https://www.airwallex.com/docs/assets/developer-tools/ai/mcp-oauth-login-page.png?width=80%) ![OAuth permission scopes page for Airwallex Developer MCP](https://www.airwallex.com/docs/assets/developer-tools/ai/mcp-oauth-scopes-page.png?width=80%) ### Claude Code You can use a one-click installation command or manual configuration. Documentation and sandbox tools at the remote endpoint. Claude Code initiates OAuth to authenticate with Airwallex. ```shell claude mcp add-json airwallex-dev '{ "type": "http", "url": "https://mcp.sandbox.airwallex.com/developer" }' ``` ### Claude.ai / Claude Cowork Connect using the built-in Airwallex Developer connector. Find the official Airwallex Developer connector from **Settings > Connectors**. ![Developer MCP Claude Web Connector Search](https://www.airwallex.com/docs/assets/developer-tools/ai/claude-web-connector-search.png?width=70%) ![Developer MCP Claude Web Connector Detail](https://www.airwallex.com/docs/assets/developer-tools/ai/claude-web-connector-detail.png?width=70%) When you try to connect, Claude initiates an OAuth flow to authenticate with Airwallex. ### Gemini CLI Add the following configuration to your Gemini CLI MCP settings. Gemini CLI initiates OAuth to authenticate with Airwallex. ```json { "mcpServers": { "airwallex-dev": { "type": "http", "url": "https://mcp.sandbox.airwallex.com/developer" } } } ``` ### OpenAI Codex Add the following to your OpenAI Codex MCP settings. Codex initiates OAuth to authenticate with Airwallex. ```toml [mcp_servers.airwallex-dev] type = "http" url = "https://mcp.sandbox.airwallex.com/developer" ``` ### Lovable Lovable is a web-based coding agent that only supports remote MCP servers. MCP server support requires a paid plan. Connect using the MCP server settings in your Lovable project. Lovable initiates OAuth to authenticate with Airwallex. ![Lovable OAuth Flow](https://www.airwallex.com/docs/assets/developer-tools/ai/lovable-oauth-flow.png?height=500) ### V0 V0 by Vercel is a web-based AI coding agent. V0 does **not** support the Developer MCP remote endpoint today. Use the [Docs MCP](#install-docs-mcp) for documentation-only access, or another coding agent if you need sandbox tools. ### Repl.it Repl.it is a web-based AI coding agent that only supports remote MCP servers. Connect using the MCP server settings in your Repl.it project. Repl.it initiates OAuth to authenticate with Airwallex. ![Repl.it OAuth Flow](https://www.airwallex.com/docs/assets/developer-tools/ai/replit-oauth-flow.png?height=500) ## Install Docs MCP Docs MCP is a documentation-only MCP server. It exposes the same documentation search tools as Developer MCP and requires no authentication. Use Docs MCP when your agent only needs to look up Airwallex docs, or when authentication is not available in the host environment. ### Cursor ![Install Airwallex Docs MCP in Cursor](/docs/assets/developer-tools/cursor-mcp-install-dark.svg) Or manually add to your Cursor MCP settings: ```json { "mcpServers": { "airwallex-docs": { "type": "http", "url": "https://mcp.sandbox.airwallex.com/docs" } } } ``` ### Claude Code ```shell claude mcp add-json airwallex-docs '{ "type": "http", "url": "https://mcp.sandbox.airwallex.com/docs" }' ``` ### Claude.ai / Claude Cowork Add a custom connector. From **Settings > Connectors > Add custom connector**, use `https://mcp.sandbox.airwallex.com/docs` as the **Remote MCP server URL**. ![Developer MCP Claude Web Custom Connector](https://www.airwallex.com/docs/assets/developer-tools/ai/claude-web-connector-custom.png?width=50%) ### Gemini CLI ```json { "mcpServers": { "airwallex-docs": { "type": "http", "url": "https://mcp.sandbox.airwallex.com/docs" } } } ``` ### OpenAI Codex ```toml [mcp_servers.airwallex-docs] type = "http" url = "https://mcp.sandbox.airwallex.com/docs" ``` ### Lovable Configure the MCP server in your Lovable project settings using `https://mcp.sandbox.airwallex.com/docs`. ![Lovable MCP Configuration](https://www.airwallex.com/docs/assets/developer-tools/ai/lovable-mcp-config.png?height=500) ### V0 ```json { "mcpServers": { "airwallex-docs": { "type": "http", "url": "https://mcp.sandbox.airwallex.com/docs" } } } ``` ![V0 MCP Configuration](https://www.airwallex.com/docs/assets/developer-tools/ai/v0-mcp-config.png?height=500) ### Repl.it Configure the MCP server in your Repl.it project settings using `https://mcp.sandbox.airwallex.com/docs`. ![Repl.it MCP Configuration](https://www.airwallex.com/docs/assets/developer-tools/ai/replit-mcp-config.png?height=500) ## Available MCP tools The two servers expose different tools: | Tool category | Developer MCP | Docs MCP | | ----------------------- | ------------- | -------- | | **Documentation tools** | ✓ | ✓ | | **Sandbox tools** | ✓ | ✗ | For prompting best practices and troubleshooting, see [Build with AI](https://www.airwallex.com/docs/developer-tools/ai/build-with-ai.md). ## Verify your connection After setup, confirm the connector is working: 1. Check that the Airwallex server appears in your editor's MCP configuration or settings panel. 2. Send a test prompt that explicitly mentions Airwallex, for example: "Using Airwallex, show me how to create a test payment link in the sandbox." 3. If the response references Airwallex documentation or invokes an Airwallex tool, the connection is working. ## Developer integration skills The `airwallex-dev` plugin adds skills that generate Airwallex integration code directly in your project. Five of them scaffold and wire SDK integration code, and `airwallex-ai-provider-card-mit` produces an implementation plan document. > **\[INFORMATIONAL]** > > The `airwallex-dev` integration skills are in beta. The skill set and behavior may change before general availability. Install the plugin from the [Airwallex marketplace](https://github.com/airwallex/airwallex-marketplace). For Claude Code: ```shell claude plugin marketplace add https://github.com/airwallex/airwallex-marketplace claude plugin install airwallex-dev@airwallex-marketplace ``` For Codex: ```shell codex plugin marketplace add https://github.com/airwallex/airwallex-marketplace codex plugin add airwallex-dev@airwallex-marketplace ``` Installed skills are prefixed by the plugin name, so you invoke them as `/airwallex-dev:airwallex-hpp`. | Skill | Category | Description | | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | [airwallex-hpp](https://github.com/airwallex/airwallex-marketplace/tree/master/plugins/airwallex-dev/skills/airwallex-hpp) | Payments | Generate Hosted Payment Page integration code: a redirect-based checkout hosted by Airwallex, covering guest, save-card, and saved-card flows. | | [airwallex-dropin](https://github.com/airwallex/airwallex-marketplace/tree/master/plugins/airwallex-dev/skills/airwallex-dropin) | Payments | Generate Drop-in Element integration code: an embedded UI that supports multiple payment methods, including Apple Pay and Google Pay. | | [airwallex-split-card](https://github.com/airwallex/airwallex-marketplace/tree/master/plugins/airwallex-dev/skills/airwallex-split-card) | Payments | Generate Split Card Element integration code: separate card number, expiry, and CVC inputs for full control over the card form. | | [airwallex-billing-checkout](https://github.com/airwallex/airwallex-marketplace/tree/master/plugins/airwallex-dev/skills/airwallex-billing-checkout) | Billing | Generate Hosted Billing Checkout integration code for subscriptions, one-off payments, and card-saving, including free trials, coupons, and webhooks. | | [airwallex-kyc](https://github.com/airwallex/airwallex-marketplace/tree/master/plugins/airwallex-dev/skills/airwallex-kyc) | Connected Accounts | Generate Connected Account KYC onboarding code using the embedded KYC element or a hosted flow. | | [airwallex-ai-provider-card-mit](https://github.com/airwallex/airwallex-marketplace/tree/master/plugins/airwallex-dev/skills/airwallex-ai-provider-card-mit) | Payments | Produce an implementation plan for card-on-file, merchant-initiated flows used by AI providers, covering top-ups, auto-recharge, and subscriptions. | These skills generate integration code in your project, so a strong coding model gives the best results. ## Next steps - [Build with AI](https://www.airwallex.com/docs/developer-tools/ai/build-with-ai.md) — prompting best practices and troubleshooting. - [Airwallex AgentOS](https://www.airwallex.com/docs/developer-tools/ai/agentos.md) — when you need agents to act on your production account. - [Airwallex CLI](https://www.airwallex.com/docs/developer-tools/cli.md) — production reads and writes from a terminal or script.