Connect and approve MCP tools

Use MCP to connect an external service’s tools to Nuvoca. Connect the server, approve the tools you need and assign them to your Agent.

Want to connect your AI assistant to Nuvoca to create Agents or analyze summaries? Use Connect Nuvoca through MCP.

1. Connect the server

Create an MCP connection with a descriptive name, the server's supported HTTPS endpoint, timeout and authentication. Select a saved credential or OAuth configuration as required by the server. Use a Streamable HTTP endpoint. Local STDIO servers are not supported by this workflow.

You need tool-management permissions and access to the selected credentials. Review the server's purpose and the actions it exposes before enabling it.

2. Discover and review

Run discovery to fetch the tool catalog. Inspect each tool's name, description and input schema. Approve only the tools required for your workflow.

New tools need approval before use. If a discovered tool changes, review the changes and approve it again when required.

3. Create and assign the Agent tool

Create an MCP tool, select the connection and an approved catalog entry, and configure its execution description. Set a caller progress message option if appropriate, then assign the saved tool to the intended Agent.

Describe when the Agent may use the tool, which details it needs and what it should do if the tool fails.

4. Test a fresh call

Test the connection and selected tool with your own test data. A tool test can change data in the connected service. Start a new call after making changes to check the current tool assignment.

Troubleshoot availability

Symptom	Check
No catalog	Endpoint, Streamable HTTP support, authentication and timeout
Tool cannot be selected	Current catalog entry is approved and available
Agent does not use the tool	Assignment, execution description and required inputs
Old behavior after a change	New approval if needed, saved assignment and a fresh call

See credential management and tool design for shared configuration practices.