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 & connections) walks through these same steps and tells you the moment the connection lands.

https://seayora.com/mcp

Claude

Claude has a one-click install link, so there is nothing to copy. Press "Connect Claude" in Settings → AI & connections on the website, or on the AI & API screen in the iPhone or Android app. Claude opens its "Add custom connector" dialog with the name Seayora and the address above already filled in, and shows that the values came from a link.

Press Add in Claude. If you are signed out, Claude signs you in first and brings you straight back to the filled-in dialog.
Claude opens the Seayora sign-in page. Enter the one-time code we send you and approve the permissions you want it to have — you can uncheck any of them.
On the website the setup page is already watching and turns green the moment the connection lands.
Start a new chat and ask it something about your account.

On a Claude Team or Enterprise plan only an owner can add a connector. The setup page offers "Add it for my Claude organization", which opens the organization's connector settings with the same values filled in; each member then presses Connect beside Seayora in Customize → Connectors. To do it by hand instead: Customize → Connectors → Add custom connector, then paste the address above.

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

The quickest way in: seayora.com/connect-ai, no sign-in needed. "Add Seayora to ChatGPT" opens ChatGPT's Plugins page and copies the address for you — ChatGPT does not let a link fill the form in itself.
In ChatGPT, open Plugins (chatgpt.com/plugins), press +, and choose "Add custom MCP server".
Name it Seayora and paste the MCP server address as the server URL.
Pick OAuth as the sign-in method, review the notice, press "Create as a plugin", 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.

Cursor or VS Code

Open Settings → AI & connections → Connect an assistant and choose "Cursor or VS Code".
Press "Add to Cursor" or "Add to VS Code". The editor opens and asks whether to install the Seayora server; accept it.
The editor opens the Seayora sign-in page in your browser. Approve the permissions you want it to have.
If nothing opens, that editor is not installed on this computer or the browser blocked the link: add the MCP server address above as a remote (HTTP) server in the editor's MCP settings instead.

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 catalog 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 & connections → API keys and copy it — it is shown only once.
Send it as Authorization: Bearer, as a Seayora-Api-Key header, or split it into Seayora-Client-Id and 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 you will see in the chat

In Claude and ChatGPT, many Seayora answers appear as a card inside the conversation rather than as a wall of text: rental listings with their photos, your rent roll as a table you can sort and filter, a portfolio summary, rent that is behind with its aging, collections by month as a chart, building health scores, the local rental market, renewals with their notice deadlines, a report, and a single property, lease, tenant or work order. The card follows your assistant’s light or dark theme, and on a phone a table turns into a list you can read without scrolling sideways.

A card shows exactly what the assistant was given — nothing more is fetched, and nobody else sees it.
When an assistant proposes a change — a work order, a message, a calendar event — the card says plainly that nothing has happened yet, and its button opens the proposal in Seayora so you can approve it there. An assistant cannot approve its own proposal.
Buttons at the foot of a card open the right page in Seayora, or suggest a sensible next question you can send with one tap.
An assistant that does not show cards gets the same answer as text.

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 checked.
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 judgment 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 recognizes 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.
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.