Back to Copilotkit

Tool Rendering Setup

showcase/integrations/claude-sdk-python/docs/setup/tool-rendering-setup.mdx

1.68.21.1 KB
Original Source

The agent must also register this schema as an executable backend tool. This setup shows the connection.

<Steps> <Step> ### Register the backend tools
`run_with_claude_agent_sdk` receives the tool schemas from the agent. It
converts each schema to an SDK tool and creates an in-process MCP server.
The adapter receives this server through `mcp_servers`. The matching
`allowed_tools` entries give Claude permission to call the tools.

<DemoCode
  file="src/agents/claude_agent_sdk_adapter.py"
  region="claude-agent-sdk-agent-setup"
/>
</Step> <Step> ### Call the CopilotKit tool handler
Each `sdk_tool_handler` calls the executable CopilotKit handler for its
schema. It returns the handler result to Claude as MCP tool content.

<DemoCode
  file="src/agents/claude_agent_sdk_adapter.py"
  region="claude-agent-sdk-tool-handler"
/>
</Step> </Steps> <Callout type="info"> This MCP path handles compatible requests that use backend tools only. Requests with frontend tools or structured user content use the direct Anthropic path. Requests with aimock transport also use this fallback. </Callout>