Connecting Claude, ChatGPT or Your Own Agent

Step-by-step instructions for connecting Claude, ChatGPT, an MCP-capable agent framework, or plain HTTP software to your Seayora account.

Every client below needs the same one thing — your MCP server address — and most of them read the rest of the configuration from Seayora themselves. The Connect an assistant screen (Settings → AI & integrations) walks through these same steps and tells you the moment the connection lands.

https://seayora.com/mcp

Claude

Open Claude, then Settings → Connectors → Add custom connector.
Paste the MCP server address above and save.
Claude opens a Seayora sign-in page. Approve the permissions you want it to have — you can untick any of them.
Start a new chat and ask it something about your account.

If Claude reports that it could not register, it is almost always a bot-protection rule in front of Seayora rather than the connector itself — see "If a connector will not register" below.

ChatGPT

In ChatGPT, open Settings → Connectors and turn on developer mode if it is off.
Choose Create, then paste the MCP server address as the MCP server URL.
Pick OAuth as the authentication method and approve the Seayora consent screen.
Ask it a question about your account, or add Seayora as a source in deep research — Seayora ships the search and fetch tools ChatGPT needs for that.

Your own agent (any MCP-capable framework)

Point your MCP client at the address above — Streamable HTTP, JSON-RPC 2.0.
For OAuth, start from https://seayora.com/.well-known/oauth-protected-resource. Dynamic client registration is open, so no pre-shared client id is needed.
For a fixed credential, create an API key and send it as Authorization: Bearer — the MCP endpoint accepts it directly.
Call tools/list first: the catalogue you get back is already filtered to the permissions you hold.

Plain HTTP (scripts, sync jobs, other software)

Create an API key under Settings → AI & integrations → API keys and copy it — it is shown only once.
Send it as Authorization: Bearer, or split it into X-Seayora-Client-Id and X-Seayora-Client-Secret if that suits your existing code.
Start at GET https://seayora.com/api/v1 for the endpoint index, or feed https://seayora.com/api/v1/openapi.json to a client generator.
Try a test-mode key first: it reads real data but every write is refused.

No Seayora account? Connect as a guest

You do not need an account to search for a home. Paste the same MCP server address into Claude or ChatGPT, and when the Seayora screen opens choose Continue as a guest instead of signing in. The connection is set up the same way and works immediately.

A guest connection can do four things: search every home advertised on Seayora, read one listing in full, look up the median asking rent for a city or neighborhood, and see when a home can be viewed. That is the same information anybody can already see on seayora.com without signing in.

No account is created and no email address is asked for or stored.
It is read-only. A guest connection holds no permission to change anything, on any workspace.
It cannot book a viewing, save a home, message a lister or apply for anything — those need a free account.
It cannot see a tenancy, a portfolio, a work order or anybody’s records, including your own if you later create an account.
It expires by itself after 30 days.

When you are ready to do more than look, create a free account at seayora.com and reconnect the same assistant signed in. Everything a guest could do stays available, plus your own tenancy or portfolio.

What happens when you approve

The assistant gets its own credential — never your password, and never a copy of your session.
It receives only the permissions you leave ticked.
The credential expires on its own and has to be refreshed, so an abandoned connection goes stale rather than living forever.
You can revoke it instantly from Connected apps, and every call it makes is logged either way.

Which applications can connect

Almost anything. Any application that speaks MCP can register itself and ask for permissions — that is deliberate, and it is what lets you connect your own script or a client we have never heard of. You choose what it may see on the consent screen, and the credential it receives belongs to you and returns only your own portfolio.

A small number of assistant vendors are not permitted to hold Seayora credentials. This is a decision about who may hold access to tenancy records — names, addresses, payment history and lease documents — not a judgement about how good a model is. If you connect one of them you will see "not permitted to connect to Seayora" at the sign-in step rather than a vague failure. If you believe an application has been declined by mistake, email [email protected] and we will look at it.

You can also revoke any connection yourself at any time from Connected apps, which kills its credential immediately.

If a connector will not register

Seayora sits behind a security layer that blocks automated traffic. Assistants are automated traffic by definition, so an over-eager bot rule can reject the connector's very first request — which the client then reports as "couldn't register with the sign-in service", even though Seayora itself is healthy. If you run your own bot protection in front of Seayora, allow /.well-known/oauth-*, /oauth/* and /mcp through it. As a fallback, most clients let you paste a credential directly instead of running the sign-in flow: create an API key and give it to the client as a bearer token.

Frequently asked questions

Which assistants are supported?

Anything that speaks MCP over Streamable HTTP with OAuth 2.1 or a bearer token — Claude and ChatGPT are the two we test against by name, and Seayora recognises both on the Connected apps screen.

Can I connect more than one?

Yes, up to the connection limit shown on the Connected apps screen. Each one gets its own credential and its own permissions.

Do I need a Seayora account to connect?

Not to search for a home. Choose Continue as a guest on the Seayora screen and the assistant can search every advertised home, read a listing, check what an area is asking in rent, and see when a place can be viewed. Booking a viewing, saving a home, messaging a lister and anything to do with a tenancy or a portfolio need a free account.

What does Seayora store about a guest connection?

No account, no profile, no email address and no saved searches. The connection itself is recorded so it can be rate-limited and expired, and it stops working on its own after 30 days.

Related guides

Related features and guides

Connecting an AI Assistant to Seayora — Documentation. What it means to connect Claude, ChatGPT or your own software to your Seayora account, what an assistant can and cannot do, and the one URL you need.
API Authentication & API Keys — Documentation. The three credentials Seayora accepts, live versus test keys, what a credential can see, and how to keep keys safe.
OAuth 2.1 for Assistants & Agents — Documentation. How an assistant discovers Seayora's sign-in, the authorization-code flow with PKCE, dynamic registration, token refresh and revocation.
How to Migrate from QuickBooks to Seayora Accounting — Guide. A step-by-step guide to connecting or importing your QuickBooks Online data into Seayora — what transfers, how to verify it, and how to avoid duplicates.
Live Support, Callbacks & Tickets — Feature. In-app live support with a real agent queue, scheduled callbacks, support tickets, business-hours awareness, and satisfaction feedback on every interaction.