Choose an integration
Catalog presence describes implementation scope, not acceptance for every account or model combination. Consult application connector evidence.
Configure a read operation
Add a connection in Console Tools, select its account and permitted operations, authorize, verify, and enable it. Begin with a read against a dedicated test document whose expected contents are known. For MCP, discover and review tool names, descriptions, and schemas before selecting them. Tools default to approval-required, even if they advertise read-only behavior. External descriptions are data, not authority to grant access. Supported transports are Streamable HTTP and legacy SSE. Generic stdio, resources/prompts subscriptions, sampling, and elicitation are not exposed. Arbitrary MCP OAuth browser registration and automatic refresh are also outside this interface. See Remote MCP.Bind the connection
With initialized clients and verified IDs, select a Harness supporting Tools:research in task instructions to explain the bound capability. The connection ID identifies account configuration; the alias names its Session binding. Tools are required at initialization by default. Add the alias to optional_tools: ['research'] only when missing authorization is acceptable. Optional status does not authorize access or bypass approval.
Required and optional bindings have different readiness rules
Optional means that readiness can be deferred. It does not mean that an alias may point to a missing, foreign-tenant or wrong-kind connection.
Use Session preflight to compare intended definitions before creating resources. For a direct definition, Python
client.preflight_session(..., tools={'research': tool_connection_id}) and TypeScript client.preflightSession({...definition, tools: {research: toolConnectionId}}) use the same initialization checks as creation; these expressions are API-shape sketches, with the Sandbox/model/Harness fields supplied by your complete definition. Add optional_tools only when the task can legitimately start without that connection being ready. A successful preflight does not approve a later operation or reserve future upstream availability.
Read initialization for the full contract. Required/optional readiness, selected operations and per-call approval are separate controls.
Start with a documented read-only call
A concrete recorded example is DeepWiki Remote MCPread_wiki_structure for modelcontextprotocol/typescript-sdk. The November 18 record describes discovery, selection of that one operation, explicit removal of approval for that reviewed read, and actual invocation through separate TypeScript/Pi and Python/OpenCode Sessions on Vercel with the configured SiliconFlow model. Both returned repository topics and confirmed cleanup. The record does not certify every MCP server, current upstream availability or arbitrary OAuth onboarding.
To repeat that pattern with your own service, follow Remote MCP setup, inspect discovery and select exactly the operation you intend. Keep approval enabled unless you have reviewed that operation and intentionally changed its policy. Bind the returned connection ID, submit one explicit read, and inspect the Tool call’s arguments and recorded content. Do not infer a real call from the assistant’s wording. For a write, continue with the approval example and verify the external result separately; the read-only record does not prove write safety.
Follow one operation through the product
Use a dedicated test record and separate the read and write tasks. First askresearch to read a known record and compare its actual response with the expected content. Then request a small, reversible update under an approval-required policy. Keep the Session ID, Run ID, Tool call ID and, when present, approval ID in your application records; they identify different objects.
A Tool alias is not a credential and does not grant extra operations. The Session’s allowed operations and current connection policy both matter. A connection that changes account identity can fail with
tool_account_changed; adding an operation to its current configuration does not automatically grant it to an existing Session. Relevant MCP schema changes can fail with mcp_schema_changed. Review the new configuration and create a new Session when the intended binding changes.