Configure MCP tools and capabilities
Use the Agent Mode settings to configure MCP servers, tools, and tool capabilities.
To open the settings, click the setting icon and select Agent Mode Setting.
Configure MCP servers and tools​
In the settings menu, you can:
-
(1) Search for an MCP tool
-
(2) Enable all/Disable all MCP tools in a server
-
(3) Enable/Disable a specific MCP tool: The AI agent will not use the tool when disabled.
-
(4) Reload an MCP server: Reloads an MCP server to fetch its up-to-date tools.
-
(5) Connect/Disconnect an MCP server: Katalon AI Assistant keeps the server's information, but no longer maintains a connection to it.
-
(6) Remove: Removes an MCP server and its tools from the list. You can always add them back later if needed.
Tool capabilities​
In the Capabilities tab, configure how and when Katalon AI Assistant can use tools.
Max tool calls​
Max tool calls limits the number of tool calls Katalon AI Assistant can make for a single prompt. The default is 100. When the agent reaches the limit, choose:
- Continue: Allows Katalon AI Assistant to exceed the limit for the current response only. The limit still applies to your next prompt.
- Stop: Stops further tool usage. Katalon AI Assistant will generate a response based on the information it has so far.
You can also click Stop at any time.
Always allow all tool calls​
Always allow all tool calls lets Katalon AI Assistant use any tool without asking for permission. This option is disabled by default.
Some actions are considered to be destructive and irreversible. Auto-granting the AI agent these permissions could lead to unwanted results.
Auto-select relevant tools​
When Auto-select relevant tools is enabled, Katalon AI Assistant selects tools for each request based on your prompt and active project context. Keep it enabled when an Agent Profile has many MCP servers or tools. Some AI service providers, such as OpenAI, allow no more than 128 tools per request.
If you encounter the invalid 'tools': array too long error, enable this setting or disable MCP servers and tools you do not need.
Reset tool approval​
Use Reset Tool Approval to revoke permissions previously set to Always Allow. The following dialog appears:
- Select an agent profile. A list displays the tools approved for that specific agent.
- Review the approved tools.
- Select the tools you want to revoke.
- Click Reset Approval, or click Cancel to exit without changes.
The assistant will ask for permission before using the reset tools again.
- Only tools set to Always Allow are listed.
- The reset applies only to the selected agent profile.
- Changes are saved automatically.
Chat memory​
- Katalon Studio 11.5.0.
In Agent mode, Katalon AI Assistant can remember durable facts about you and your project and apply them in later chats, including after you restart Katalon Studio. Memory is stored locally, is specific to your Katalon account, and is never uploaded or shared.
The assistant can save preferences or project details, such as your preferred browser or naming conventions. Each saved fact appears in the conversation as a save_memory tool action.
To turn memory on or off, under Memory, select Learn and apply memory from chats to use memory. Clear it to stop saving new facts and applying saved ones.
The Project memory card shows how many memories are saved and when they were last updated.
- To review or edit saved facts, select the open icon to open the memory file in the editor.
- To remove all saved facts, select the delete icon.
Add facts to memory​
Katalon AI Assistant can save a fact on its own when it learns something durable during a chat. You can also ask it to memorize something at any time: send the information in Agent mode and ask the assistant to add it to memory.
Add this to your memory: Always use Chrome for web tests,
and name test cases in the format TC_<feature>_<scenario>.
The same prompt lets you bring in memory from another AI chat tool, such as Claude or ChatGPT. Export your memory from that tool, paste it into the Agent mode chat, and ask Katalon AI Assistant to add it to memory. The assistant keeps the durable facts and skips temporary details, such as the current status of a ticket.