Development ### Database Migrations Create a new migration: ```bash npx prisma migrate dev --name migration-name ``` Apply migrations: ```bash npm run migrate ``` ### Testing Run tests: ```bash npm test ``` Run linter: ```bash npm run lint ``` ## Architecture The server acts as a multi-tenant proxy between MCP clients and Integration App's MCP server: ``` MCP Client -> Multi-tenant Server -> Integration App MCP Server (proxy/router) ``` Each tenant gets: - Isolated MCP client connection - Separate Integration App credentials - Independent tool discovery - Audit logging ## Security - Rate limiting per tenant - CORS protection - Helmet security headers - Request ID tracking - Audit logging - Token-based authentication ## Monitoring The `/health` endpoint provides: - Server status - Active tenant count - Database connection status - Memory usage - Uptime ## License MIT # MCP Service Documentation ## Overview This service provides a multi-tenant API for managing integrations and tools via the Model Context Protocol (MCP). Each tenant is isolated and can access only their own tools and data. --- ## 1. Creating a Tenant To create a new tenant, you must have an **admin token**. Use the following steps: ### Step 1: Obtain an Admin Token Send a POST request to `/api/auth/token` with your admin API key: ```bash curl -X POST https:///api/auth/token \ -H "Content-Type: application/json" \ -d '{"key": ""}' ``` **Response:** ```json {"token": ""} ``` ### Step 2: Create the Tenant Send a POST request to `/api/tenants` with the admin token in the `Authorization` header: ```bash curl -X POST https:///api/tenants \ -H "Content-Type: application/json" \ -H "Authorization: Bearer " \ -d '{ "name": "", "integrationKey": "", "integrationAppToken": "" }' ``` **Response:** ```json { "tenantId": "tenant-xxxxxxx", "apiKey": "", ... } ``` --- ## 2. Generating a Tenant Token To interact with the API as a tenant, you need a tenant JWT token. Generate it using the tenant's API key: ```bash curl -X POST https:///api/auth/tenant-token \ -H "Content-Type: application/json" \ -H "x-api-key: " ``` **Response:** ```json {"token": ""} ``` --- ## 3. Listing Tools for a Tenant To list the tools available to a tenant, use the following endpoint with both the tenant API key and JWT token: ```bash curl -X POST https:///api/tenant//tool \ -H "Content-Type: application/json" \ -H "x-api-key: " \ -H "Authorization: Bearer " \ -d '{"method": "listTools"}' ``` **Response:** ```json { "tools": [ { "name": "create-contact", ... }, ... ] } ``` --- ## 4. Executing a Tool as a Tenant To execute a tool (e.g., create a contact): ```bash curl -X POST https:///api/tenant//tool \ -H "Content-Type: application/json" \ -H "x-api-key: " \ -H "Authorization: Bearer " \ -d '{ "method": "create-contact", "params": { "email": "test.user@example.com", "fullName": "Test User" } }' ``` **Response:** ```json { "content": [ { "type": "text", "text": "{\"id\":\"120688589560\"}" } ], "isError": false } ``` --- ## 5. Connecting an MCP Client Application To connect an MCP client as a tenant: - Use the tenant's `integrationKey` and `integrationAppToken` (from the tenant creation response) to initialize the client. - Authenticate API requests with both the tenant API key and the tenant JWT token as shown above. **Example Client Initialization:** ```js const client = new IntegrationAppClient({ token: '' }); const integration = await client.integration('').get(); // ... ``` --- ## 6. Troubleshooting - Ensure you use the correct tenant `id` and not `tenantId` for foreign key references in the

#mcpservice

Multi-tenant MCP Server