nt 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 database. - Both the tenant API key and JWT token are required for all tenant-specific API calls. - If you see foreign key errors, check your database schema and migrations. - For rate limiting issues, consider setting `app.set('trust proxy', 1)` if running behind a proxy (see Express rate-limit docs). --- ## 7. Example .env File ``` DATABASE_URL=postgresql://user:password@host:port/dbname ADMIN_API_KEY=your_admin_api_key ``` --- ## 8. Useful Endpoints - `POST /api/auth/token` — Get admin token - `POST /api/tenants` — Create tenant (admin only) - `POST /api/auth/tenant-token` — Get tenant JWT token - `POST /api/tenant/:tenantId/tool` — List or execute tools as a tenant --- For more details, see the code in `src/server.ts` and `src/api/auth.ts`.25:T54d,## What is MCP Service? MCP Service is a multi-tenant M

#multi-tenant

Multi-tenant MCP Server