connecting-a-server

by Omniio

Diagnose and explain why a tool the user expected is missing from an Omniio gateway, and tell them exactly how to connect the server that provides it. Use when search_tools returns nothing for a product the user clearly uses, when a tool call fails because a server is not authorized, or when the user asks how to add a service to their gateway.

Using this gatewayAlways on1 file

What it tells an agent to do.

The author’s own instructions, as your agent receives them — the same bytes the endpoint serves.

When the tool you need is not there

search_tools only returns tools from servers this account has enabled. Omniio's library carries far more than any one account has switched on, and most of them need a credential of their own before they return anything.

So "no results" usually means one of three things, and they need different answers.

1. The server exists but is not enabled

The common case. The library has it; this account has not turned it on.

Tell the user, specifically:

I don't have any Slack tools connected. You can enable Slack at https://omniio.dev/app/library — search for it and switch it on.

Name the product. "You need to connect a server" is not actionable.

2. The server is enabled but not authorized

Some servers are reachable the moment they are switched on because they need no credential. Most need the user to sign in to that product and hand Omniio a token for it. Until they do, the server is enabled but has no tools.

The fix is the same page — https://omniio.dev/app/library — but the action is Connect, not the toggle. Say which one you mean.

Credentials are per person. One member of a team connecting GitHub does not connect it for anyone else.

3. The library does not carry it

The catalogue is curated, not crawled — every entry is a server somebody checked. If a product genuinely is not there, say so rather than guessing at an endpoint, and point them at https://omniio.dev/support to request it.

Do not

  • Do not claim a tool exists because the product does. Search first.
  • Do not invent a server slug or an endpoint URL.
  • Do not tell the user to edit a config file. Connecting a server is done in the Omniio app; their MCP client configuration does not change — the gateway URL stays the same however many servers sit behind it.
  • Do not ask them for an API key. Omniio holds credentials; you should never receive one, and a user pasting a token into a chat is a token you have just put somewhere it does not belong.

More in using this gateway

finding-and-calling-tools

Omniio

Find and correctly call a tool on an Omniio MCP gateway. Use whenever a request could be served by an external system — live data, a lookup, or an action in a c

What it does →

handling-held-and-refused-calls

Omniio

Respond correctly when an Omniio tool call is held for human approval, denied by policy, or refused for a spent approval. Use when run_tool returns a message ab

What it does →

limits-and-retries

Omniio

Decide whether a failed Omniio call should be retried, and how long to wait. Use when a tool call or REST request returns a rate limit, a quota message, a 4xx o

What it does →