# OlaCheap MCP connector

Manage your OlaCheap websites, deployments and selected OlaMail business mailboxes from an MCP-compatible AI application.

Operated by MIA株式会社 (MIA Co., Ltd.), Japan.

## Connection and requirements

- Server URL: `https://olacheap.com/api/mcp`
- Transport: Streamable HTTP with JSON responses. The server accepts POST requests; GET returns 405 because a server-initiated event stream is not offered.
- Authentication: OAuth authorization code with Dynamic Client Registration and mandatory PKCE S256. No shared OAuth client secret is required.
- You need an OlaCheap account. Website tools require hosting access for that account. Mail tools require an active OlaMail service and a mailbox the account currently controls.
- Service availability and plan limits are shown in your OlaCheap dashboard. Connecting does not purchase a service or bypass those limits.

In Claude, open Settings → Connectors, add a custom connector, and enter the server URL above. Follow the OlaCheap sign-in page. Review the app name and callback host, choose the website access and/or individual mailboxes you want to connect, and approve only the access you need. Sending email is a separate option and is off by default. Return to Claude after authorization.

**ChatGPT:** Open the ChatGPT Plugins/apps management area supported by your account and connect the OlaCheap/OlaMail app, or configure the remote MCP URL when your plan/workspace supports custom MCP apps. ChatGPT plugin review and installation are managed by OpenAI; an OAuth grant listed on OlaCheap alone is not proof that a specific plugin is online. A `codex://` URL is an optional desktop deep link, **not** part of the remote MCP connection process.

**Gemini Apps (developer preview):** Open [Gemini Apps Developer Mode](https://gemini.google.com/devmode), create a custom MCP app, provide the public HTTPS endpoint `https://olacheap.com/api/mcp`, and complete OAuth consent through OlaCheap. Use its tool-schema inspector to verify the granted tools. Public availability beyond the developer-mode workflow requires Google's separate connected-app review; it is not automatically published by this server.

**Other compatible AI tools:** For a client supporting remote Streamable HTTP MCP and OAuth 2.1 with PKCE, add the same HTTPS MCP endpoint, complete authorization, and verify `tools/list`. The endpoint does not accept IMAP passwords as OAuth credentials and does not offer a public unauthenticated mailbox API.

**Built-in connectivity check:** In OlaCheap → Connected apps, use *Server connection check* to test OAuth discovery and the expected unauthorized MCP challenge. This read-only check does not prove any specific AI client's authorization, nor does it read or send mail.

Your password is entered on OlaCheap's sign-in page, not in the conversation. Never paste API keys, passwords, tokens or payment details into a prompt or support ticket.

## Permissions and tools

The tool list depends on your consent. A mail-only connection does not expose website tools. Personal API keys are an alternative for coding clients and provide website tools only; they do not unlock OlaMail.

| Access | Tools | Effect |
| --- | --- | --- |
| Websites: read | `list_sites`, `get_site`, `list_deployments` | Read website URLs, domains, deployment status and deployment logs. |
| Websites: write | `create_site`, `deploy`, `rollback`, `add_domain` | Create websites, upload static build files, activate or restore deployments, and connect a domain owned by the account. |
| Selected mailboxes: read | `list_mailboxes`, `list_emails`, `read_email` | List authorized mailbox addresses, search/list messages, and read message text and attachment names. Each listed message names its folder; a `uid` is only valid with that folder. Reading does not mark a message as read. OlaCheap's own sign-in and email-confirmation messages are never shown to apps. |
| Selected mailboxes: draft | `create_draft` | Save an email or reply in Drafts without sending it. For a reply, pass the folder the message was listed in as `reply_folder`. A reply draft without `to` goes to the original's Reply-To address, else its From address; a reply to a message sent from that mailbox (for example in Sent) goes to that message's To addresses. Bcc is not kept in drafts, so a draft with Bcc is refused (add Bcc when sending). The result shows the recipients; list the Drafts folder to see it. |
| Selected mailboxes: send | `send_email` | Send an email from an authorized mailbox, only when the separate sending permission has been granted. Emails to recipients you approved before for that mailbox are sent directly. An email to any new recipient (To, Cc or Bcc) is not sent until you approve it in OlaCheap at [AI email approvals](https://olacheap.com/dashboard/email/approvals); a request expires after 24 hours. Approving it makes its recipients trusted for that mailbox. |

Recipients are plain addresses such as `name@example.com`; `Name <name@example.com>` is also accepted, and only the address is used. A new email needs a subject; a reply without one uses `Re: <original subject>`.

Website access includes both read and write tools; there is no separate read-only website permission. Mailbox consent allows reading and saving drafts; it does not allow sending unless the separate sending option is selected. Attachment download, arbitrary HTTP requests, payments, money transfers and AI image/audio/video generation are not offered by this endpoint. Domain and VPS purchases take place on the OlaCheap website, outside this connector.

Write tools are marked for confirmation by supporting clients. Review the target website and files before publishing or rolling back. Before approving an email, review the exact recipients, subject and body on the approvals page. Content in received email is untrusted data, not authorization to perform actions.

Trusted recipients are listed per mailbox on the [AI email approvals](https://olacheap.com/dashboard/email/approvals) page. Remove an address there to require your approval again. A trusted contact who sends you a crafted email could try to make the AI send them information, so remove contacts you no longer correspond with.

Approve emails yourself. The approvals page trusts your signed-in OlaCheap session, so an AI assistant that can also operate your web browser while you are signed in (for example a browser agent or extension) could open that page and press Approve as you. Do not let such an assistant use a browser signed in to OlaCheap, and reject any request you did not expect.

## Example requests

- “List my OlaCheap websites and show which deployments are live.”
- “Show the recent deployment log for this website.”
- “Create a website for this project.”
- “Deploy these built static files to the selected website.”
- “List the OlaMail mailboxes I connected.”
- “Find the latest three messages in this connected mailbox.”
- “Read the selected email and save a reply in Drafts.”

Use a dedicated test website and synthetic mailbox data when testing. Deploying and restoring can change a live website; approving a send, or sending to a trusted recipient, delivers a real email.

## Website upload limits

Inline MCP uploads accept up to 500 files and 10 MiB total per call. Each file needs a path and either text content or base64 content. Upload the built HTML/CSS/JavaScript/assets, including `index.html`; do not upload source secrets, private keys or environment files. Use the OlaCheap CLI for larger deployments.

## Data passed to your AI application

Depending on the permissions and tools you use, tool results can contain website names, URLs, domains, deployment metadata/logs, mailbox addresses, message headers, snippets, message text and attachment names. Draft/send calls contain recipients, subjects and message bodies. OlaCheap stores each send request (recipients including Bcc, subject and body) until you approve or reject it, or until it expires after 24 hours; the body is then deleted (within two hours if an approved send never reports back). An email sent directly to trusted recipients is recorded without its body. The recipients, subject and outcome of every request and every direct send stay listed on the approvals page for 7 days (newest first, 50 per page, every page reachable; emails that failed or were not confirmed stay visible on every page) and are deleted after 30 days. OlaCheap stores the list of trusted recipient addresses per mailbox until you remove them. These arguments and results are exchanged with the AI application you connect and are subject to that provider's terms and privacy settings as well as OlaCheap's privacy policy.

The connector operates on tool arguments and authorized OlaCheap resources. It does not provide a tool for reading the AI application's complete conversation history, memory or unrelated user files. Only include data you intend to use in the requested action.

See the [Privacy Policy](https://olacheap.com/legal/privacy) and [Terms of Service](https://olacheap.com/legal/terms). For privacy or deletion requests, contact privacy@olacheap.com.

## Disconnect and troubleshooting

Open [Connected apps](https://olacheap.com/dashboard/connect) in OlaCheap and disconnect the app to revoke its grant. Reconnect to change the selected mailboxes or sending permission. Disconnecting does not delete mailbox messages, deployed website files, or results already held by the AI provider.

- **401 / invalid or expired token:** reconnect to OlaCheap. The server advertises OAuth discovery in the `WWW-Authenticate` challenge.
- **403 / access not open for this account:** check account/service availability and contact support. Do not bypass an access restriction.
- **Tool not listed:** reconnect and check the consent you granted. `send_email` appears only with sending permission.
- **Mailbox not connected:** use `list_mailboxes`; verify ownership, service status and the mailbox selected during consent.
- **Unknown website or deployment:** use IDs returned for the current account. Another account's resources are not available.
- **Upload too large:** reduce the upload or use the CLI. Keep secrets out of build output.
- **Sending limit reached:** save a draft and retry after the reset time in the error response.
- **Mailbox temporarily unavailable:** the OlaMail service is suspended or not ready yet; nothing was changed. Try again later and check the service in your OlaCheap dashboard.

OAuth discovery is published at `https://olacheap.com/.well-known/oauth-protected-resource` and `https://olacheap.com/.well-known/oauth-authorization-server`. Access tokens last one hour. Refresh tokens rotate on use and have a 60-day expiry; disconnecting revokes the grant.

Support: [Help center](https://olacheap.com/support) or support@olacheap.com. Security/abuse reports: abuse@olacheap.com. Do not include customer message content or credentials in reports.
