The Spaceti Intelligence MCP server lets AI assistants (such as Claude, ChatGPT, Gemini, and Microsoft Copilot) securely query your Spaceti workplace data (occupancy, environmental readings, and more) directly inside a conversation.

This guide explains how to connect each supported AI client.

Server URL: https://intelligence.spaceti.ai/mcp

Authentication: OAuth. When you connect, a browser window opens and asks you to sign in with your Spaceti account and authorize access. The assistant never sees your password, and it can only access the data your Spaceti user is already permitted to see.

Note: These steps describe adding the Spaceti Intelligence MCP manually using the server URL. We're also working on getting a fully certified Spaceti listing in each vendor's connector directory / marketplace (Claude, ChatGPT, Gemini, and Microsoft Copilot), which will let you discover and add it natively without pasting a URL. This guide will be updated as those listings go live.

Before You Start

You need a Spaceti account with the Intelligence Pro license and access to the buildings and data you want to query.
The MCP server is reachable over the public internet; you don't need to be on a corporate VPN.
Connecting is per person: each user signs in with their own Spaceti login.
Some clients require a paid plan, or an administrator to enable the feature first, as noted in each section.
The assistant can only access the Spaceti data your own account is already permitted to see.

Claude

Works on claude.ai, Claude Desktop, and the mobile apps (Free, Pro, Max, Team, and Enterprise plans).

Open Settings > Connectors (also shown as Customize > Connectors).
Click the + button and choose Add custom connector.
Fill in the details:
- Name: Spaceti Intelligence
- Remote MCP server URL: https://intelligence.spaceti.ai/mcp
- Leave Advanced settings (OAuth Client ID / Secret) blank. The Spaceti server handles OAuth automatically.
Click Add. A browser window opens; sign in with your Spaceti account and authorize the connection.
To use it in a chat, click the + button in the message bar, open Connectors, and toggle Spaceti Intelligence on.

Plan notes

Free accounts can add one custom connector.
On Team and Enterprise plans, an Owner must first add the connector under Organization settings > Connectors. After that, each member connects individually with their own Spaceti login.

ChatGPT

Custom MCP connections live behind Developer mode (called apps since late 2025). Available on Plus, Pro, Business, Enterprise, and Edu plans, on the web.

Open Settings > Apps & Connectors > Advanced settings and turn on Developer mode. On Business / Enterprise / Edu workspaces, an admin must enable Developer mode at the workspace level (Workspace Settings > Permissions & Roles) before members can use it.
In Apps & Connectors, choose Create app (or Add custom connector).
Fill in the details:
- Name: Spaceti Intelligence
- Description: e.g. "Query Spaceti workplace occupancy and environmental data."
- MCP server URL: https://intelligence.spaceti.ai/mcp
- Authentication: OAuth
Save the app. An OAuth popup appears: sign in with your Spaceti account and authorize. (Make sure popups aren't blocked.)
In a chat, enable Developer mode in the composer and toggle the Spaceti Intelligence app on. When the assistant calls a Spaceti tool, approve the action when prompted.

Gemini

The most direct way to connect with OAuth browser login is through the Gemini CLI.

Note: As of mid-2026, the Gemini CLI is being transitioned to the Antigravity CLI for unpaid and Google One tiers. The MCP configuration steps are the same; only the command name may differ.

Install the CLI and sign in with your Google account:
```
npm install -g @google/gemini-cli
```

Open your configuration file at ~/.gemini/settings.json and add the Spaceti server:

{
  "mcpServers": {
    "spaceti": {
      "httpUrl": "https://intelligence.spaceti.ai/mcp",
      "oauth": { "enabled": true }
    }
  }
}

Restart the CLI, then start the OAuth flow:
```
/mcp auth spaceti
```
A browser window opens; sign in with your Spaceti account and authorize. Tokens are stored locally. If they expire, run the same command again.
Verify the connection and see the available tools:
```
/mcp
```

Gemini web app (Gemini Enterprise)

To make Spaceti Intelligence available inside the Gemini web experience, an administrator adds it as a custom MCP server data store in the Google Cloud console (Gemini Enterprise > Data stores > Add > Custom MCP Server), registering Gemini Enterprise as an OAuth client and entering the server URL. This is an admin task and requires a Google Cloud / Gemini Enterprise setup.

Microsoft Copilot

Microsoft 365 Copilot uses an MCP through an agent built in Copilot Studio: you create the MCP tool, add it to an agent, publish the agent, and make it available to your organization. This is an administrator setup. Each end user connects with their own Spaceti login the first time they use the agent.

Go to https://copilotstudio.microsoft.com.
Open Tools.
Create a new tool.
Select Model Context Protocol.
Fill in the details and create the tool:
- Server name: Spaceti Intelligence MCP
- Server description: Spaceti Intelligence MCP provides access to the analytics data under your Spaceti tenant(s)
- Server URL: https://intelligence.spaceti.ai/mcp
- Authentication: OAuth 2.0
- Type: Dynamic discovery
Open Agents, create a new agent, and open it.
In the agent, open Tools.
Click Add a tool, select Model Context Protocol, and search for Spaceti.
Under Connection, click Not connected, then Create new connection. If you're signed in to your Spaceti account it connects automatically; otherwise it walks you through the Spaceti login.
Click Add and configure. The agent now lists all the Spaceti tools.
(Optional) Test the MCP here. This re-triggers the authentication process.
Finish any other agent settings you want, for example an icon.
Go to Channels and pick where the agent should appear (e.g. Microsoft 365 and Microsoft Teams). Open Availability options, choose Show to everyone in my org, then Submit to org catalog. This sends the app for your Microsoft Teams admin's approval.
Your Microsoft Teams admin approves the request at https://admin.teams.microsoft.com/policies/manage-apps by clicking Publish on the new agent app. It can take some time for the agent to appear in Copilot.
Back in Copilot Studio, Publish the agent as well.
First-time connection (each user): when a user opens the agent and sends their first prompt, they click Open connection manager and connect. Signed-in Spaceti users connect automatically; others are walked through the Spaceti login.
Spaceti analytics are now available in Copilot.

Verifying the Connection

After connecting in any client, ask a simple question that requires Spaceti data, for example:

"Using the Spaceti Intelligence tools, what was yesterday's average occupancy in my building?"

If the assistant returns live figures (rather than a generic answer), the connection is working.

Troubleshooting

Symptom	What to check
OAuth window doesn't appear	Allow popups for the AI client in your browser, then retry.
"Not authorized" or no data returned	Confirm your Spaceti account has access to the building/data you're querying. The assistant inherits your permissions.
Connection works, then stops after a while	The OAuth token may have expired. Re-authorize: re-run the sign-in (Gemini CLI: `/mcp auth spaceti`; other clients: reconnect the connector).
The connector option is missing	Check your plan and, in an organization, whether an admin needs to enable the feature first (see the plan notes in each section).
Copilot Studio rejects the server	Verify the server is reached over Streamable HTTP at the `/mcp` endpoint; SSE transport is not supported.
Copilot agent ignores the Spaceti tools	Confirm the Spaceti tool is added to the agent and connected, that generative orchestration is on (default for new agents), and that your prompt clearly calls for workplace/occupancy data.
Agent doesn't appear in Copilot for users	The app must be approved by your Microsoft Teams admin and the agent published in Copilot Studio. Allow some time for it to propagate.
Claude can't reach the server	The server must be reachable from the AI provider's cloud. If your network restricts it, contact your Spaceti administrator.

Security and Privacy

The Spaceti Intelligence MCP uses OAuth, so the AI client receives a scoped access token rather than your credentials.
The assistant can only read the Spaceti data your own account is permitted to see.
You can revoke access at any time by removing the connector in your AI client and/or revoking the authorization in your Spaceti account settings.

Once you're connected, just ask your assistant for workplace data in plain language. If anything is unclear, reach out to your Spaceti contact.

Connecting the Spaceti Intelligence MCP to Your AI Assistant