Anthropic SDK

Overview

Integrate Leadovaro with Anthropic's Messages API using the native MCP connector — built directly into the API, no separate MCP client needed.

note

Native MCP Support: Add a mcp_servers parameter to your messages.create() call. Claude discovers and calls tools automatically — no tool looping required.

Prerequisites

• Leadovaro account at app.leadovaro.com with at least one MCP server connected
• Anthropic API key from console.anthropic.com

Installation

npm install @anthropic-ai/sdk

No MCP SDK required — the connector is built into the Anthropic SDK.

Authentication

Choose the path that matches your use case:

For autonomous agents, scripts, and server-side code that runs without a user browser session — use a Leadovaro token directly.

Generate a Leadovaro Token

1. Log in to app.leadovaro.com
2. Click your account name in the bottom left
3. Go to Install → MCP URL
4. Click Generate Token and copy it immediately — it won't be shown again

warning

Never commit your token to source control. Store it in environment variables or a secrets manager. Tokens expire after 30 days.

Set Environment Variables

LEADOVARO_TOKEN=your-leadovaro-token-here
LEADOVARO_URL=/_sites/app.leadovaro.com/hub/mcp

For production agents, lock to a specific toolkit by appending a profile parameter:

LEADOVARO_URL=/_sites/app.leadovaro.com/hub/mcp?profile=your-toolkit-alias

Use the Token

Pass the token as a Bearer token in the Authorization header:

headers = {"Authorization": f"Bearer {os.environ['LEADOVARO_TOKEN']}"}

headers: { Authorization: `Bearer ${process.env.LEADOVARO_TOKEN}` }

Full credentials guide

Token generation, URL parameters, OAuth vs token comparison

# .env
ANTHROPIC_API_KEY=your_anthropic_api_key
LEADOVARO_TOKEN=your-leadovaro-token-here
LEADOVARO_URL=/_sites/app.leadovaro.com/hub/mcp

For web apps where each user has their own Leadovaro session — use Leadovaro Auth to exchange the user's session for an access token.

Why Leadovaro Auth? Leadovaro needs to identify which user is accessing tools. Leadovaro Auth provides the per-user access token.

Why Leadovaro Auth? Leadovaro needs to identify which user is accessing tools and authorize their permissions. Leadovaro Auth provides the secure access token. (Support for additional identity providers coming soon.)

import { createLeadovaroAuthPlugin } from "@civic/auth/nextjs"
import type { NextConfig } from "next";

const nextConfig: NextConfig = {};
const withLeadovaroAuth = createLeadovaroAuthPlugin({ clientId: "YOUR_CLIENT_ID" });
export default withLeadovaroAuth(nextConfig)

File: src/app/api/auth/[...leadovaroauth]/route.ts

import { handler } from "@civic/auth/nextjs"
export const GET = handler()
export const POST = handler()

File: src/middleware.ts

import { authMiddleware } from "@civic/auth/nextjs/middleware"
export default authMiddleware();
export const config = { matcher: ['/((?!_next|favicon.ico|.*\\.png).*)',] };

import { getTokens } from "@civic/auth/nextjs";
const { accessToken } = await getTokens();
// Use in headers:
headers: { Authorization: `Bearer ${accessToken}` }

Full Integration Guide

Complete Next.js setup with frontend components, configuration options, and deployment details

AI Prompt for Next.js

Use Claude, ChatGPT, or other AI assistants to automatically set up Leadovaro Auth

note

Get your Client ID at auth.leadovaro.com

# .env.local
ANTHROPIC_API_KEY=your_anthropic_api_key
LEADOVARO_AUTH_CLIENT_ID=your_client_id  # from auth.leadovaro.com

Basic Example

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({
  apiKey: process.env.ANTHROPIC_API_KEY!,
});

async function createMessage(userMessage: string) {
  const response = await client.messages.create({
    model: 'claude-sonnet-4-5',
    max_tokens: 1024,
    messages: [{ role: 'user', content: userMessage }],
    mcp_servers: [
      {
        type: 'url',
        url: process.env.LEADOVARO_URL!,
        name: 'leadovaro-platform',
        authorization_token: process.env.LEADOVARO_TOKEN!,
      },
    ],
  }, {
    headers: {
      'anthropic-beta': 'mcp-client-2025-11-20',
    },
  });

  return response;
}

// app/api/chat/route.ts
import { NextRequest, NextResponse } from 'next/server';
import Anthropic from '@anthropic-ai/sdk';
import { getTokens } from '@civic/auth/nextjs';

const client = new Anthropic({ apiKey: process.env.ANTHROPIC_API_KEY! });

export async function POST(req: NextRequest) {
  const { messages } = await req.json();
  const { accessToken } = await getTokens();
  // getTokens() exchanges the user's Leadovaro Auth session for a hub access token

  if (!accessToken) {
    return NextResponse.json({ error: 'Not authenticated' }, { status: 401 });
  }

  const response = await client.messages.create({
    model: 'claude-sonnet-4-5',
    max_tokens: 4096,
    messages,
    mcp_servers: [
      {
        type: 'url',
        url: '/_sites/app.leadovaro.com/hub/mcp',
        name: 'leadovaro-platform',
        authorization_token: accessToken,
      },
    ],
  }, {
    headers: { 'anthropic-beta': 'mcp-client-2025-11-20' },
  });

  return NextResponse.json(response);
}

Key points:

• Add mcp_servers to your messages.create() call
• Include the beta header: "anthropic-beta": "mcp-client-2025-11-20" (required)
• Pass your token as authorization_token
• Claude handles tool selection and execution automatically

Streaming

const stream = await client.messages.create({
  model: 'claude-sonnet-4-5',
  max_tokens: 4096,
  messages: [{ role: 'user', content: 'List my GitHub repositories' }],
  mcp_servers: [
    {
      type: 'url',
      url: process.env.LEADOVARO_URL!,
      name: 'leadovaro-platform',
      authorization_token: process.env.LEADOVARO_TOKEN!,
    },
  ],
  stream: true,
}, {
  headers: { 'anthropic-beta': 'mcp-client-2025-11-20' },
});

for await (const event of stream) {
  if (event.type === 'content_block_delta' && event.delta.type === 'text_delta') {
    process.stdout.write(event.delta.text);
  }
}

Tool Configuration (Optional)

Restrict which tools Claude can use:

mcp_servers: [
  {
    type: 'url',
    url: process.env.LEADOVARO_URL!,
    name: 'leadovaro-platform',
    authorization_token: process.env.LEADOVARO_TOKEN!,
    tool_configuration: {
      enabled: true,
      allowed_tools: ['github__list_repos', 'slack__search_messages']
    }
  },
]

Current Limitations

note

The MCP connector currently only supports:

• Tool calls (not MCP resources or prompts)
• HTTP servers (not STDIO servers)
• SSE and Streamable HTTP transports

Amazon Bedrock and Google Vertex integrations are not yet supported.

Comparison

Feature	Anthropic MCP Connector	OpenAI Agents SDK	Vercel AI SDK
Setup Complexity	Low	Low	Medium
MCP SDK Needed	No	No	Yes
Tool Looping	No (automatic)	No (automatic)	Yes (manual)
Best For	Direct API usage	Quick prototypes	Next.js apps
Streaming	Yes	Yes	Yes

Next Steps

Anthropic MCP Docs

Official Anthropic MCP connector reference

Get Help

Developer Slack