---
title: "Astro"
description: "Use Integrate with Astro"
---
## Installation

Install the Integrate SDK in your Astro project:

```bash
bun add integrate-sdk
```

## Setup

### 1. Server Configuration

Create a server configuration file with your OAuth credentials:

```typescript
// lib/integrate.ts
import { createMCPServer, githubIntegration } from "integrate-sdk/server";

export const { client: serverClient } = createMCPServer({
  apiKey: import.meta.env.INTEGRATE_API_KEY,
  integrations: [
    githubIntegration({
      clientId: import.meta.env.GITHUB_CLIENT_ID,
      clientSecret: import.meta.env.GITHUB_CLIENT_SECRET,
      scopes: ["repo", "user"],
    }),
  ],
});
```

You can get an API key from the [Integrate Dashboard](https://integrate.dev/dashboard/login).

### 2. Mount the Handler

Create a catch-all API route at `pages/api/integrate/[...all].ts`:

```typescript
import { serverClient } from "@/lib/integrate";
import type { APIRoute } from "astro";

export const ALL: APIRoute = async (ctx) => {
  return serverClient.handler(ctx.request);
};
```

## Configuration

Add your OAuth credentials to your `.env` file:

```bash
GITHUB_CLIENT_ID=your_github_client_id
GITHUB_CLIENT_SECRET=your_github_client_secret
```

## Usage Examples

### Client-Side Authorization

The client is automatically configured when making requests to the server.

```typescript
import { client } from "integrate-sdk";

await client.authorize("github");
```