Skip to content

Connecting an AI assistant

Let Claude, or another assistant that supports MCP connectors, look things up and make changes in your Horizline account.

Updated

This is being introduced account by account. If Settings → Integrations has no AI assistants section, it is not switched on for your account yet; write to support to ask for it.

Connect an assistant

  1. In your assistant, add a custom connector. There are step-by-step guides, with screenshots, for Claude, ChatGPT, Grok and Muse.
  2. Give it this address: https://mcp.horizline.app/mcp. It is also in Settings → Integrations → AI assistants, with a button to copy it.
  3. The assistant opens a Horizline page. Sign in if asked. The page names the application that is asking, where your answer is sent, and what it may do.
  4. Untick anything you do not want it to do, then choose Connect.

You never give the assistant your Horizline password. Connect only when you started the connection yourself; if a page asks you to connect something you did not just add, choose Cancel.

What it can do

The assistant works as you. It sees and changes only what your own account can, in your own workspace, and nothing in anyone else's. You choose how much of that it gets:

  • See your contacts, jobs, tasks, follow-ups, material requests, invoices, payments and reports. Always included.
  • Add and change leads, clients, jobs, tasks, follow-ups, notes and material requests.
  • Prepare invoices and change what jobs are worth: invoice drafts, job values, completing a job, approving materials.

It cannot change your password, your team, your billing with Horizline, or your settings, and it cannot take a payment or send an invoice on its own.

What waits for your approval

Deleting a record, and anything that changes money, does not happen when the assistant asks. Horizline gives the assistant a link instead. Open it, signed in as yourself, and you see exactly what will happen: which record, which amounts, what cannot be undone. Choose Approve or Decline.

  • An approval is for that one action, with those details, once.
  • It expires after 15 minutes if you do not answer.
  • Only the person who connected the assistant can approve. The link alone approves nothing.

Anything waiting is also listed under Settings → Integrations → AI assistants.

Approve only what you asked for. An assistant reads emails, notes and web pages, and text in those can try to steer it. The approval page is there so that nothing permanent or financial happens without you reading it first.

Team members

Only the account owner can connect an assistant, until the owner turns on Let team members connect their own assistants in the same section. A team member's assistant has that team member's permissions, never the owner's. Turning the switch off ends every team member's connection at once.

Disconnect

Go to Settings → Integrations → AI assistants, find the connection and choose Disconnect. It stops working immediately. The owner can disconnect anyone's.

A connection also ends by itself when you change your password or two-step verification, or when the account is disabled or removed.

The record of what it did

The same section lists each thing an assistant did and whether it worked. Changes it made also appear in the Activity Log under your name with (AI assistant) after it, so you can tell them from changes you made by hand.

If something does not work

  • “This connection request was stopped”: remove Horizline from your assistant, add it again with the address above, and start over.
  • “This request has expired”: the sign-in page is good for ten minutes. Start again from your assistant.
  • The assistant says it is not permitted: you left that kind of action unticked when you connected, or your account does not have the permission. Disconnect and connect again to change what you ticked.
  • The assistant says it was slowed down: it made too many requests in a minute. It can carry on after a short wait.