Integrations

Integrations

Outside services the agent uses as tools. Each integration is a hosted MCP server.

Coming soon
AI agents are not available on StackBlaze yet. This page describes how they work so you can plan for them; names, limits and details can change before they are released.

An integration gives the agent tools from an outside service, like looking up an issue or an order. Each one is a hosted MCP server. Open the agent, go to Agent → Integrations, and click Add integration.

FieldWhat to enter
ServiceA listed service, or Another MCP server (any hosted server, by URL).
NameLowercase letters, digits and dashes, up to 32. The tools show up as mcp__<name>_<tool>.
Server URLFor Another MCP server. Must be https, by host name. A service of this environment can be named as http://<service>/mcp.
TokenThe secret the server needs. Optional for Another MCP server.
HeaderOptional, for Another MCP server. Empty sends Authorization: Bearer <token>.

An https server must resolve to a public address. When you add one, StackBlaze connects to the server and lists its tools. If the server refuses the token, the integration is not added and you are asked to paste it again. A server that cannot be reached is still added; while it does not answer, the agent simply has none of its tools.

Adding or removing an integration restarts the agent. An agent can have up to 10.

The token

The token is kept in the agent's variables, masked like any secret, and never shown again. The list shows token stored or no token. Use a token limited to what the agent should be able to do.

Each token goes only to its own server. The agent's configuration holds a reference to the variable, never the secret.

Public agents

Integrations are off while the website widget is on, because a visitor could talk the agent into using them. Turn the widget off in Triggers to add integrations. See Security and limits.

In evals

An eval check can require a tool call. mcp__<integration> matches any tool of that integration. See Evals.

API

POST /api/ai-agents/{pipeline}/{phase}/{name}/integrations with { name, url, token?, header?, scheme?, label? } adds one. DELETE …/integrations/{id} removes it and its stored token. See API.