Skip to main content

Connect an AI Assistants to Alcove (MCP)

Connect Claude, ChatGPT, Perplexity, Cursor, and other AI assistants to Alcove with a single read-only access token.

Written by Valeria Albino

AI Assistants lets you connect external AI tools—like Claude, ChatGPT, Perplexity Computer, Cursor, and other MCP-compatible clients—to your Alcove account.

Once connected, those assistants can answer questions about your projects using live Alcove data. This is different from the AI features built into Alcove (such as Talk to Your Project). AI Assistants brings your preferred tools into the conversation with Alcove as the source of truth.

Important Note:
AI Assistants access is read-only. Connected assistants can look up projects, products, orders, and financial documents. They cannot create, edit, or delete records in Alcove.

What you get

With AI Assistants connected, you can ask your preferred AI tools things like:

  • Which projects are active in my Alcove account?

  • What’s on this project—products, orders, or open invoices?

  • Summarize project financial documents (estimates, invoices, retainers, quotes)

  • Help me draft a client or vendor update using real Alcove data

How it works

  1. You generate an access token in Alcove.

  2. You add Alcove as a custom MCP / connector in your AI tool using the MCP server URL and your token.

  3. Your assistant uses Alcove’s read-only tools to answer questions about your company data.

Treat your access token like a password. Anyone with the token can read the same Alcove data your user can see.

Steps to set up AI Assistants

To connect an AI assistant to Alcove, please follow the steps below:

  1. Log into your Alcove account and click the Profile icon in the top right.

  2. Go to the Account tab >> Connected Accounts.

  3. Locate the AI Assistants row and press Set up (or Manage if you already have a token).

  4. On the AI Assistants page, choose a Hard token limit (for example, 1 year).
    Tokens also expire after 30 days of inactivity, even if the hard limit has not been reached.

  5. Click Generate Token.

  6. Copy the MCP server URL and the Access token.
    The access token is shown once—copy it before you leave the page.

  7. In your AI tool, add a custom MCP / connector:

    • Server URL: paste the MCP server URL from Alcove

    • Auth / API key: paste your Alcove access token (Bearer / API key)

  8. Enable the connector, then ask your assistant to verify with something like: “Use Alcove to get my profile” or “List my Alcove projects.”

Connect a specific assistant

Use the setup sections on the AI Assistants page for step-by-step guidance. In short:

Cursor

  1. Open SettingsTools & MCPNew MCP Server (or edit ~/.cursor/mcp.json / project .cursor/mcp.json).

  2. Add a remote server with the Alcove MCP URL and Authorization: Bearer YOUR_ALCOVE_ACCESS_TOKEN in headers (see the AI Assistants page for a full JSON example).

  3. Save, reload Cursor if needed, then ask it to run alcove_get_profile.

Claude Code

  1. Run claude mcp add --transport http alcove <MCP_URL> --header "Authorization: Bearer YOUR_ALCOVE_ACCESS_TOKEN".

  2. Confirm with claude mcp list, then ask Claude Code to run alcove_get_profile.

Claude (custom connector / Cowork / claude.ai)

  1. Open Claude → CustomizeConnectorsAdd custom connector.

  2. Paste the MCP server URL.

  3. Under Request headers, add authorization with value Bearer YOUR_ALCOVE_ACCESS_TOKEN (include the word Bearer and a space).

  4. Enable the connector, then ask Claude to get your Alcove profile.

Claude Desktop (local extension)

  1. On the AI Assistants page, click Install Claude Desktop to download the Alcove extension (when available).

  2. Generate a token in Alcove.

  3. Use Copy Claude prompt (or paste the token with the Alcove session tool in Claude Desktop).

  4. Run a quick profile check to confirm the connection.

ChatGPT (Developer Mode / custom MCP app)

  1. In ChatGPT (web), open SettingsSecurity and login and turn on Developer mode.

  2. Open SettingsApps / Plugins → create a developer-mode app with the MCP server URL.

  3. ChatGPT custom MCP apps use OAuth or no auth, not a static Bearer key. Prefer Cursor, Claude, Claude Code, or Perplexity for Alcove’s Bearer token today.

  4. If tools load, ask ChatGPT to get your Alcove profile.

Perplexity Computer

  1. Requires a paid plan. Open perplexity.ai/computer/connectors.

  2. Click + Custom connector, paste the MCP server URL, and under Advanced choose API Key with your Alcove access token.

  3. Use Transport Streamable HTTP, add and enable the connector.

  4. Start a Computer session and ask it to list your Alcove projects.

Other MCP clients

  1. Point a remote / Streamable HTTP MCP client at the Alcove MCP server URL.

  2. Send Authorization Bearer (or your client’s API-key field).

  3. Verify with a profile or session status check.

Manage or revoke access

You can manage AI Assistants anytime from Account >> Connected Accounts >> AI Assistants >> Manage.

  • Rotate Token — creates a new token. Update your AI tools with the new token; the previous token stops working.

  • Revoke — immediately disconnects AI Assistants access. You can revoke from the page header or the Access token card.

If you believe a token was shared or exposed, revoke it right away and generate a new one.

Best practices

  • Generate a token only when you are ready to paste it into your AI tool.

  • Store tokens in your assistant’s secure settings—not in shared docs or chat threads.

  • Prefer a hard limit (such as 1 year) instead of Forever unless you specifically need an open-ended token.

  • After rotating or revoking, update or remove the connector in each AI tool you use.

  • Always verify important financial or client decisions against the data you see in Alcove.

Important notes

  • Access is scoped to your Alcove user and company. Assistants only see data you are allowed to see.

  • Access is read-only in this version. Assistants cannot change projects, products, orders, or financial documents.

  • This connection is separate from built-in Alcove AI (Talk to Your Project, Financial Insights, Markup Suggestions).

  • Availability of custom MCP / connectors depends on each AI product’s settings (some require developer or advanced connector options).

AI Assistants turns the tools you already use into a smarter layer on top of Alcove—so you can ask questions in Claude, ChatGPT, Perplexity, Cursor, and more, without exporting spreadsheets first.

Did this answer your question?