# Connect An Agent

Canonical URL: https://agent.payrail.one/docs/guides/connect-agent
Markdown URL: https://agent.payrail.one/docs/guides/connect-agent.md
Summary: Use this guide to install the native Payrail Agent plugin, authenticate its remote MCP, verify capabilities, and run the first Memory-managed workflow.
Description: Connect Payrail Agent to a supported personal AI agent runtime and prepare the protected checkout steps.

## Canonical Answer

Use this guide to install the native Payrail Agent plugin, authenticate its remote MCP, verify capabilities, and run the first Memory-managed workflow. Connect Payrail Agent to a supported personal AI agent runtime and prepare the protected checkout steps. Protected payment and identity data stays behind Payrail Agent requests instead of entering LLM-visible context.

## Before You Start

You need one supported runtime where the agent can install skills or persistent instructions and connect a remote MCP server. Use the runtime's native MCP authentication flow rather than a local Payrail Agent command.

## Install The Right Surface

Install the host-native Payrail Agent plugin. It contains only the skill, the skill-shipped Payrail Agent Fill actuator, and a remote MCP declaration. The host keeps using its own built-in browser; no package, Payrail Agent CLI, library, local service, or second browser runtime is installed.

## Authenticate Once

Use the MCP connection page opened by the host. Enter the email and OTP there; the same OAuth flow verifies the account, authorizes the remote MCP, and redirects to the host. Never send the setup OTP through agent chat.

## Verify

Confirm the runtime can call the remote Payrail Agent MCP before starting a real checkout flow.

1. Call `get_payrail_agent_capabilities` through the connected remote MCP.
2. Require `client_browser`, remote database session authority, and skill-script Payrail Agent Fill delivery.
3. Restart the runtime if newly installed skills are not visible.
4. Begin with a browser-only task, then move to a protected form such as a shipping address.

Note: Done when: capabilities are available, the agent can open a page with its built-in browser, and a Payrail Agent request shows up in your approval channel.

## Related

- Agent Skills: https://agent.payrail.one/docs/integrations/agent-skills
- Claude App: https://agent.payrail.one/docs/integrations/claude
- ChatGPT App: https://agent.payrail.one/docs/integrations/chatgpt