@assistant-ui/mcp-docs-server 0.2.2 → 0.3.0

package/.docs/raw/docs/cloud/authorization.mdx

@@ -1,252 +0,0 @@
----
-title: User Authorization
-description: Configure workspace auth tokens and integrate with auth providers.
----
-
-The Assistant Cloud API is accessed directly from your frontend. This eliminates the need for a backend server for most operations—except for authorizing your users.
-
-This guide explains how to set up user authentication and authorization for Assistant Cloud.
-
-## Workspaces
-
-Authorization is granted to a **workspace**. A workspace is a scope that contains threads and messages. Most commonly:
-
-- Use a `userId` as the workspace for personal chats
-- Use `orgId + userId` for organization-scoped conversations
-- Use `projectId + userId` for project-based apps
-
-## Authentication Approaches
-
-Choose the approach that fits your app:
-
-| Approach | Best For | Complexity |
-|----------|----------|------------|
-| **Direct auth provider integration** | Supported providers (Clerk, Auth0, Supabase, etc.) | Low |
-| **Backend server** | Custom auth, multi-user workspaces, or self-hosted solutions | Medium |
-| **Anonymous mode** | Demos, prototypes, or testing | None |
-
-### Direct Integration with Auth Provider
-
-In the Assistant Cloud dashboard, go to **Auth Integrations** and add your provider. This sets up automatic workspace assignment based on the user's ID from your auth provider.
-
-Then pass an `authToken` function that returns your provider's ID token:
-
-```ts
-import { AssistantCloud } from "@assistant-ui/react";
-
-const cloud = new AssistantCloud({
-  baseUrl: process.env.NEXT_PUBLIC_ASSISTANT_BASE_URL!,
-  authToken: () => getTokenFromYourProvider(), // Returns JWT
-});
-```
-
-### Backend Server Approach
-
-Use this when you need custom workspace logic or unsupported auth providers.
-
-<Steps>
-<Step>
-
-#### Create an API Key
-
-In the Assistant Cloud dashboard, go to **API Keys** and create a key. Add it to your environment:
-
-```bash
-ASSISTANT_API_KEY=your_key_here
-```
-
-</Step>
-<Step>
-
-#### Create the Token Endpoint
-
-```ts title="/app/api/assistant-ui-token/route.ts"
-import { AssistantCloud } from "assistant-cloud";
-import { auth } from "@clerk/nextjs/server"; // Or your auth provider
-
-export const POST = async (req: Request) => {
-  const { userId, orgId } = await auth();
-
-  if (!userId) return new Response("Unauthorized", { status: 401 });
-
-  // Define your workspace ID based on your app's structure
-  const workspaceId = orgId ? `${orgId}_${userId}` : userId;
-
-  const assistantCloud = new AssistantCloud({
-    apiKey: process.env.ASSISTANT_API_KEY!,
-    userId,
-    workspaceId,
-  });
-
-  const { token } = await assistantCloud.auth.tokens.create();
-  return new Response(token);
-};
-```
-
-</Step>
-<Step>
-
-#### Use the Token on the Frontend
-
-```tsx title="app/chat/page.tsx"
-const cloud = new AssistantCloud({
-  baseUrl: process.env.NEXT_PUBLIC_ASSISTANT_BASE_URL!,
-  authToken: () =>
-    fetch("/api/assistant-ui-token", { method: "POST" }).then((r) => r.text()),
-});
-
-const runtime = useChatRuntime({
-  cloud,
-});
-```
-
-</Step>
-</Steps>
-
-### Anonymous Mode (No Auth)
-
-For demos or testing, use anonymous mode to create browser-session-based users:
-
-```tsx
-import { AssistantCloud } from "@assistant-ui/react";
-
-const cloud = new AssistantCloud({
-  baseUrl: process.env.NEXT_PUBLIC_ASSISTANT_BASE_URL!,
-  anonymous: true,
-});
-```
-
-<Callout type="warning">
-  Anonymous mode creates a new user for each browser session. Threads won't persist across sessions or devices. Use this only for prototyping.
-</Callout>
-
-## Auth Provider Examples
-
-### Clerk
-
-<Steps>
-<Step>
-
-#### Configure the JWT Template
-
-In the Clerk dashboard, go to **Configure → JWT Templates**. Create a new blank template named "assistant-ui":
-
-```json
-{
-  "aud": "assistant-ui"
-}
-```
-
-<Callout type="info">
-  The `aud` claim ensures the JWT is only valid for Assistant Cloud.
-</Callout>
-
-Note the **Issuer** and **JWKS Endpoint** values.
-
-</Step>
-<Step>
-
-#### Add Auth Integration in Assistant Cloud
-
-In the Assistant Cloud dashboard, go to **Auth Rules** and create a new rule:
-
-- **Provider**: Clerk
-- **Issuer**: Paste from Clerk JWT Template
-- **JWKS Endpoint**: Paste from Clerk JWT Template
-- **Audience**: `assistant-ui`
-
-</Step>
-<Step>
-
-#### Use in Your App
-
-```tsx
-import { useAuth } from "@clerk/nextjs";
-import { AssistantCloud } from "@assistant-ui/react";
-
-function Chat() {
-  const { getToken } = useAuth();
-
-  const cloud = useMemo(
-    () =>
-      new AssistantCloud({
-        baseUrl: process.env.NEXT_PUBLIC_ASSISTANT_BASE_URL!,
-        authToken: () => getToken({ template: "assistant-ui" }),
-      }),
-    [getToken],
-  );
-
-  // Use with your runtime...
-}
-```
-
-</Step>
-</Steps>
-
-### Auth0
-
-```tsx
-import { useAuth0 } from "@auth0/auth0-react";
-import { AssistantCloud } from "@assistant-ui/react";
-
-function Chat() {
-  const { getAccessTokenSilently } = useAuth0();
-
-  const cloud = useMemo(
-    () =>
-      new AssistantCloud({
-        baseUrl: process.env.NEXT_PUBLIC_ASSISTANT_BASE_URL!,
-        authToken: () => getAccessTokenSilently(),
-      }),
-    [getAccessTokenSilently],
-  );
-
-  // Use with your runtime...
-}
-```
-
-Configure the Auth0 integration in the Assistant Cloud dashboard with your Auth0 domain and audience.
-
-### Supabase Auth
-
-```tsx
-import { useSupabaseClient } from "@supabase/auth-helpers-react";
-import { AssistantCloud } from "@assistant-ui/react";
-
-function Chat() {
-  const supabase = useSupabaseClient();
-
-  const cloud = useMemo(
-    () =>
-      new AssistantCloud({
-        baseUrl: process.env.NEXT_PUBLIC_ASSISTANT_BASE_URL!,
-        authToken: async () => {
-          const { data } = await supabase.auth.getSession();
-          return data.session?.access_token ?? "";
-        },
-      }),
-    [supabase],
-  );
-
-  // Use with your runtime...
-}
-```
-
-### Firebase Auth
-
-```tsx
-import { getAuth, getIdToken } from "firebase/auth";
-import { AssistantCloud } from "@assistant-ui/react";
-
-function Chat() {
-  const cloud = useMemo(() => {
-    const auth = getAuth();
-    return new AssistantCloud({
-      baseUrl: process.env.NEXT_PUBLIC_ASSISTANT_BASE_URL!,
-      authToken: () => getIdToken(auth.currentUser!, true),
-    });
-  }, []);
-
-  // Use with your runtime...
-}
-```

package/.docs/raw/docs/cloud/index.mdx

@@ -1,46 +0,0 @@
----
-title: Cloud Persistence
-description: Add managed thread persistence and chat history to your AI app in minutes — assistant-ui Cloud handles thread sync, search, and multi-tenant storage.
----
-
-Assistant Cloud is a hosted service that adds thread management, message persistence, and user authorization to AI chat applications. It works with any React UI—whether you use assistant-ui components or your own.
-
-## What You Get
-
-- **Thread Persistence** — Messages automatically save as conversations progress. Users can resume chats at any time, even across sessions.
-- **Thread List** — Built-in UI components (or hooks) for browsing, switching, and managing conversations.
-- **Auto-Generated Titles** — Conversations get meaningful titles based on the initial messages.
-- **User Authorization** — Integrates with your auth provider to scope threads per user or workspace.
-
-## Supported Backends
-
-| Backend | Standalone Mode | With assistant-ui |
-|---------|----------------|-------------------|
-| AI SDK | [`useCloudChat`](/docs/cloud/ai-sdk) | [`useChatRuntime`](/docs/cloud/ai-sdk-assistant-ui) / `AISDKThreads` |
-| LangGraph | — | [`useLangGraphRuntime`](/docs/cloud/langgraph) |
-| Custom | — | Local Runtime |
-
-## Getting Started
-
-<Callout type="info">
-  You'll need an Assistant Cloud account. [Sign up here](https://cloud.assistant-ui.com/) to create a project.
-
-  From your project settings, copy the **Frontend API URL** (`https://proj-[ID].assistant-api.com`)—you'll need it for the guides below.
-</Callout>
-
-### Choose Your Integration Path
-
-**Using AI SDK with your own UI?**  
-→ Follow the [AI SDK guide](/docs/cloud/ai-sdk) for the `useCloudChat` hook. One hook, minimal changes to your existing code.
-
-**Want pre-built components like `<Thread />` and `<ThreadList />`?**  
-→ Follow the [AI SDK + assistant-ui guide](/docs/cloud/ai-sdk-assistant-ui) for full UI components with cloud persistence.
-
-**Using LangGraph?**  
-→ Follow the [LangGraph guide](/docs/cloud/langgraph) for cloud-backed LangGraph Cloud integration.
-
-## Example Repositories
-
-- [AI SDK (standalone)](https://github.com/assistant-ui/assistant-ui/tree/main/examples/with-cloud-standalone) — Minimal `useCloudChat` setup
-- [AI SDK + assistant-ui](https://github.com/assistant-ui/assistant-ui/tree/main/examples/with-cloud) — Full component integration
-- [LangGraph + assistant-ui](https://github.com/assistant-ui/assistant-ui/tree/main/examples/with-langgraph) — LangGraph Cloud with persistence