Name: Integrate
Author: Integrate

Installation

Install the Integrate SDK in your SolidStart 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: process.env.INTEGRATE_API_KEY,
  integrations: [
    githubIntegration({
      scopes: ["repo", "user"],
    }),
  ],
});

SolidStart supports automatically importing the environment variables from the .env file.

You can get an API key from the Integrate Dashboard.

2. Mount the Handler

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

import { toSolidStartHandler } from "integrate-sdk/server";
import { serverClient } from "~/lib/integrate";

const handlers = toSolidStartHandler(serverClient);

export const { GET, POST, PATCH, PUT, DELETE } = handlers;

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");

SolidStart