{"document":{"id":"agent-alerts-doc-remote-mcp","kind":"doc","slug":"remote-mcp","title":"Remote MCP","description":"Connect ChatGPT, Codex, Claude, or Cursor to send Agent Alerts through account sign-in.","keywords":["Agent Alerts","MCP","ChatGPT","Codex","Claude","Cursor","OAuth","connect"],"updatedAt":"2026-11-10","content":"# Remote MCP\n\nConnect ChatGPT, Codex, Claude, or Cursor to send Agent Alerts through account sign-in.\n\nConnect an AI client to Agent Alerts through account sign-in. Your client can then send updates to the iPhone signed in with that account.\n\n## Before connecting\n\nInstall [Agent Alerts](https://apps.apple.com/us/app/agent-alerts/id6760969938), finish onboarding, and sign in on your iPhone. Make sure your AI client supports remote HTTP MCP connections and browser authentication.\n\n## Add the server\n\nUse this endpoint for sending alerts:\n\n```text\nhttps://www.andreas.ink/api/agent/mcp\n```\n\nFor a guided connection flow, open [MCP setup](/agent/mcp).\n\n### Codex\n\n```bash\ncodex mcp add agent-alerts --url https://www.andreas.ink/api/agent/mcp\ncodex mcp login agent-alerts --scopes openid,email,profile,offline_access\n```\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http --scope user agentalerts https://www.andreas.ink/api/agent/mcp\n```\n\nThen open Claude Code, run `/mcp`, and follow the browser sign-in flow.\n\n### ChatGPT, Claude, and Cursor\n\nAdd a custom remote HTTP MCP connection in the client's connector or MCP settings. Paste the endpoint above, then follow its browser authentication flow. Client names and settings can differ by version; [MCP setup](/agent/mcp) links to each client's official instructions.\n\n## Sign in and test\n\nUse the same account as your iPhone and review the access request before approving it. Ask the client to check Agent Alerts status, then send a non-sensitive test update.\n\nFor example:\n\n```text\nCheck my Agent Alerts connection. Send one test update saying that setup is ready, then tell me the returned delivery status. I will confirm it on my iPhone.\n```\n\nAn accepted request is not proof that the Live Activity or notification appeared. Confirm the result on the phone before relying on the connection.\n\n## Agree on the workflow\n\nTell your agent what to check, which sources it may use, when to refresh, and what needs a notification. Reuse a stable activity key for the same subject. The AI client owns checks and recurring schedules; Agent Alerts receives the updates.\n\nAlarms require an explicit user request. A pending or expired response is not permission to take an action. See [responses and permissions](/agent-alerts/docs/responses-and-permissions).\n\n## Need an unattended connection?\n\nFor a service that cannot complete browser authentication, use an iPhone-approved publishing token with the [webhook API](/agent-alerts/docs/webhook-api) or [Swift CLI](/agent-alerts/docs/swift-cli). Keep the token in the runtime's secret storage.\n\nThe [public docs MCP](/agent-alerts/docs#read-with-an-agent) is a separate, read-only knowledge connection. It does not sign you in or send alerts.\n","path":"docs/remote-mcp","url":"https://www.andreas.ink/agent-alerts/docs/remote-mcp","markdownUrl":"https://www.andreas.ink/api/agent-alerts/content?path=docs%2Fremote-mcp&format=markdown"}}