Concepts

AI

How Monospace's AI works — the embedded assistant and the MCP server, and the tools and permissions they share.

Overview

Monospace exposes AI in two ways, both built on the same foundation:

  • The Assistant — an AI chat panel inside the Studio.
  • The MCP server — a Model Context Protocol endpoint for external AI agents and tools.

Both work through the same set of tools and run under the permissions of whoever — or whatever — is using them. Neither can do anything the acting user or API key is not already allowed to do.

What the AI Can Do

Through either surface, the AI works with your workspace using the same capabilities:

  • Read the schema — collections, fields, and relations.
  • Query items, using the same filtering the API supports.
  • Create, update, and delete items.
  • Read and change the schema.
  • List the workspace's data sources.

Every action is checked against the acting identity's permissions: item operations follow collection permissions, and reading or changing the schema requires the data-model entitlement. The AI cannot do more than its user or key already can.

The Assistant

The Assistant is an AI chat panel in the Studio. Ask it to find, summarize, or change data in natural language; it keeps context within a conversation, and you can start a new chat at any time. Because it runs as you, it sees and changes only what your roles allow.

Configuring the Assistant

Configure the Assistant per workspace under Settings → AI. Connect a provider with its API key, then choose a chat model for responses and a fast model for lighter tasks, with optional reasoning and a reasoning level. Use Test Connection to confirm the provider works.

Configuring the provider requires the ai:admin entitlement; using the Assistant requires ai:access.

The MCP Server

The MCP server exposes the same capabilities to external AI agents and tools over the Model Context Protocol. Each workspace has its own endpoint, and agents authenticate with an API key — so an agent acts with exactly that key's permissions. Using it requires the ai:mcp entitlement.

See Configure MCP to connect an agent.

See Also

Copyright © 2026