Get started

Install the MCP integration and Core from the same release channel:

pnpm add @anvia/core @anvia/mcp

Connect several independently owned clients with McpClientGroup:

import { Agent } from '@anvia/core/agent'
import { McpClient, McpClientGroup } from '@anvia/mcp'

const filesystem = new McpClient({
  name: 'filesystem',
  transport: {
    type: 'stdio',
    command: 'npx',
    args: ['-y', '@modelcontextprotocol/server-filesystem', './workspace'],
  },
})

const issues = new McpClient({
  name: 'issues',
  transport: {
    type: 'streamableHttp',
    url: 'https://mcp.example.com/mcp',
    headers: { authorization: `Bearer ${process.env.MCP_TOKEN}` },
  },
  tools: { prefix: 'issues_' },
})

const group = await McpClientGroup.connect({ clients: [filesystem, issues] })
const agent = new Agent({ id: 'operator', model, mcpServers: group.servers })

try {
  await agent.generate({ prompt: 'Inspect the repository and its open issues.' })
} finally {
  await group.close()
}

Static HTTP headers are sent only to the exact endpoint, never to OAuth traffic, and are not forwarded across redirects. A static authorization header cannot be combined with authProvider.

For a trusted local or private-network HTTP server, set ssrfProtection: 'disabled'. Do not derive that setting from user or model input. See MCP transports for the complete boundary.