Step 1
Create your HAVN MCP key
- Open HAVN on iPhone, iPad, Android, or the web app.
- Go to Settings and find MCP access.
- Tap Create key. HAVN shows the full key once so you can reveal and copy it.
- Use the key as a Bearer token with the HAVN MCP endpoint.
Step 2
Connect common AI clients
Connect as a ChatGPT connector
- Open ChatGPT Settings and go to Connectors.
- Enable Developer Mode while HAVN is not yet listed as an official public app.
- Add the MCP server URL.
- When ChatGPT opens HAVN authorization, paste your HAVN MCP key and approve.
Connect with Claude remote MCP
- Open Claude settings for integrations or connectors.
- Add a custom integration that points to the HAVN endpoint.
- Complete HAVN authorization with your MCP key when Claude opens the OAuth flow.
- For Claude Code, use the HTTP command below instead.
claude mcp add --transport http havn https://mcp.havnre.app/mcp \
--header "Authorization: Bearer YOUR_HAVN_MCP_API_KEY"Add the HTTP MCP server
- Open the MCP server configuration for VS Code.
- Add HAVN as an HTTP MCP server.
- Set the Authorization header to Bearer YOUR_HAVN_MCP_API_KEY.
{
"mcpServers": {
"havn": {
"type": "http",
"url": "https://mcp.havnre.app/mcp",
"headers": {
"Authorization": "Bearer YOUR_HAVN_MCP_API_KEY"
}
}
}
}Use the standard remote MCP pattern
Most MCP-capable coding assistants accept either a remote MCP URL with headers or a JSON mcpServers configuration. Use the same endpoint and Bearer token shown above.
{
"mcpServers": {
"havn": {
"type": "http",
"url": "https://mcp.havnre.app/mcp",
"headers": {
"Authorization": "Bearer YOUR_HAVN_MCP_API_KEY"
}
}
}
}What AI can ask for
Available HAVN tools
workspace_summary A compact overview of the user's HAVN workspace.
search_properties Find properties the user can access.
get_property_media Fetch permission-checked property image links and metadata for HTML pages, brochures, and AI-generated drafts.
search_contacts Search contacts connected to the user's role or agency.
search_open_houses Find open houses and showing activity.
search_leads Search leads for follow-up context.
search_tasks Search accessible tasks with property, contact, lead, and open-house links.
search_seller_reports Search seller reports with property context, report metrics, and AI summary data.
analytics_summary Fetch scoped agency, property, lead-conversion, and open-house analytics.
search_files Search accessible uploaded files and return signed URLs for private attachments.
search_media Search property photos, contact media, agent avatars, agency icons, and contact pass assets.
Security model
Role-scoped access, not a database login
How HAVN limits access
- Every user gets a separate MCP key.
- Keys are validated by HAVN before any tool reads data.
- Results are scoped to the user and agency role stored in HAVN.
- Property media links are returned only for properties visible to that user or agency role.
- Private attachment links are short-lived signed URLs generated only after HAVN confirms access.
- Keys can be rotated or revoked from Settings.
How to handle your key
- Treat the key like a password.
- Do not paste it into public chats, tickets, screenshots, or source code.
- Rotate the key if a device or AI account is shared with someone else.
- Remove unused connectors in each AI client.
Legal and privacy
Important terms for MCP access
Does the AI get my full database?
No. HAVN checks the user's API key, role, and agency access before returning data. Tools return scoped results rather than a raw database connection.
Can I revoke access?
Yes. Open Settings in HAVN, revoke or rotate the MCP key, then remove the connector from the AI client.
Is the API key shown again later?
No. The full key is shown only when it is created. After that, HAVN stores only a hash and a short prefix for identification.
Does MCP change my HAVN subscription?
No. MCP is an access bridge. It may increase normal usage of HAVN infrastructure when AI clients call tools more often.
By connecting HAVN to an AI client, you authorize HAVN to send scoped account, property, contact, open house, lead, task, file, media, report, and workspace data to that client when you ask it to use HAVN tools.
The AI provider may process that data under its own terms, privacy policy, and workspace settings. Review HAVN policies and each AI provider's policies before connecting production client or brokerage data.
Provider docs