Skip to main content

Use MCP in a Reasoning Session

Connect the required MCP server before asking an agent to use its tools or resources.

Check the server​

  1. Open Settings → Agents → MCP Servers.
  2. Find the server required by the task.
  3. Enable or connect it when it is inactive.
  4. Select the authentication action when the remote server requires sign-in.
  5. Wait for the state to report that the server is connected.

Use Reload after editing MCP configuration outside the extension.

Ask for the capability​

Return to Chat and describe the result you need. Name the connected system or server when more than one tool could match the request.

For an operation that changes external data, state the allowed scope and ask the agent to preview or summarize the intended change before execution. Review the MCP permission request before allowing it.

Resolve a missing tool​

If a tool is unavailable:

  • confirm that the correct project or global configuration is active;
  • check whether the server is disabled, failed, or waiting for authentication;
  • verify required environment values without posting their contents in Chat;
  • confirm that the selected agent is allowed to use the tool;
  • reload configuration and try again.

An agent requirement can block a session until its MCP server is ready. Connect the named server or choose an agent that does not require it.

Disconnect or disable a server when its tools should no longer be available. This does not undo external actions already completed.