Name: Integrate
Author: Integrate

Installation

Install the Integrate SDK in your Astro project:

bun add integrate-sdk

Setup

1. Server Configuration

Create a server configuration file with your OAuth credentials:

// 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.

2. Mount the Handler

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

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:

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.

import { client } from "integrate-sdk";

await client.authorize("github");

Astro