MCP — the Model Context Protocol — lets your AI client talk to your Homaic data directly. You bring your own AI subscription (Claude, GPT, whatever); Homaic exposes the tools. Everything you can do in the Homaic dashboard, your AI can do for you, on your data, using your model.
This is Mode B. Mode A — the in-product AI — keeps working alongside it.
Why this matters
If you already pay for Claude Code or ChatGPT or Cursor, you don't need a second AI subscription to use Homaic. You already have the smart part. Homaic is the data, the schema, and the OAuth-authenticated tool surface that lets the AI you already use do useful work on your home.
What you need
- A Homaic account.
- An MCP-aware AI client (Claude Code, Cursor, Cline, ChatGPT desktop with custom MCPs, or any client that speaks MCP).
- Five minutes.
Connect Claude Code
In Claude Code, run /mcp and add a remote MCP server pointing at https://api.homaic.io/mcp. Claude Code opens a browser window to authenticate against your Homaic account. Approve the scopes — Homaic uses RFC-compliant OAuth — and you're connected. The full toolset (capture asset, search manifest, generate brief, list service events, log communication, etc.) is available in your next prompt.
Connect Cursor
Cursor's MCP configuration lives in ~/.cursor/mcp.json. Add a remote server entry pointing at https://api.homaic.io/mcp with transport: "http". Cursor walks you through OAuth on first connection. Restart Cursor.
Connect Cline
Cline (the VS Code extension) supports MCP through its settings panel. Add a new MCP server with URL https://api.homaic.io/mcp. The OAuth flow runs in your browser; the bearer token is stored by Cline.
Self-hosted clients
If you self-host Homaic, point your MCP client at your own host: https://your-host.example.com/mcp. The OAuth flow is the same; the user database is yours.
Troubleshooting
Connection fails immediately. Verify the URL — https://api.homaic.io/mcp, not homaic.io/mcp and not app.homaic.io/mcp.
OAuth window opens but never returns. The redirect URI is registered against your client ID. If you changed clients (e.g., reinstalled Claude Code), revoke the old token from your Homaic settings and reconnect.
Tools don't appear. Disconnect and reconnect. Some clients cache the tool list aggressively. Restart the client process if needed.
"Unauthorized" on every call. Your token expired or was revoked. Reconnect via OAuth.
If none of those resolves it, email support@homaic.io with the client name, version, and the exact error.