> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mcp-assistant.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart Guide

> Quickstart for mcp-ts: install the SDK, wire up a Next.js MCP route, and connect from React with the useMcp hook to call your first MCP tool.

This guide will help you set up a basic MCP connection using `mcp-ts`.

## 1. Install

```bash theme={null}
npm install @mcp-ts/sdk
```

## 2. Server-Side Setup (Next.js)

Create an API route at `app/api/mcp/route.ts` to handle MCP connections.

```typescript theme={null}
import { createNextMcpHandler } from '@mcp-ts/sdk/server';

export const { GET, POST } = createNextMcpHandler({
  getUserId: (req) => "user_123", // Replace with actual auth
});
```

## 3. Client-Side Setup

Use the React `useMcp` hook in your component to connect and call tools.

```tsx theme={null}
'use client';
import { useMcp } from '@mcp-ts/sdk/client/react';

export function McpApp() {
  const { connections, connect, callTool, status } = useMcp({
    url: '/api/mcp',
    userId: 'user_123',
  });

  const handleConnect = () => {
    connect({
      serverId: 'everything-server',
      serverName: 'Everything Server',
      serverUrl: 'https://everything.mcp.run',
    });
  };

  return (
    <div>
      <h3>Status: {status}</h3>
      <button onClick={handleConnect}>Connect to Server</button>

      {connections.map(conn => (
        <div key={conn.sessionId}>
          <h4>{conn.serverName} ({conn.state})</h4>
          {conn.tools.map(tool => (
            <button key={tool.name} onClick={() => callTool(conn.sessionId, tool.name, {})}>
              Run {tool.name}
            </button>
          ))}
        </div>
      ))}
    </div>
  );
}
```

## 4. Environment Variables

By default, `mcp-ts` uses in-memory storage. For persistence, add a backend like Redis:

```bash theme={null}
REDIS_URL=redis://localhost:6379
```

## Next Steps

* Integrate with [AI SDK](/ai-adapters/ai-sdk)
* Configure [Production Storage](/storage-backends/redis)
* Explore the [API Reference](/reference/server)