Server deployments define which integrations and tools your AI agents can access through Metorial.

What Are Server Deployments?

A server deployment is a configuration that:

• Defines which integrations are available to your application
• Manages authentication and permissions for those integrations
• Provides the tools that AI models can call

Think of it as a "toolbox" for your AI agents - you control what's inside.

Creating a Server Deployment

1. Log in to Metorial: Access your dashboard at metorial.com
2. Navigate to Deployments: Find "Server Deployments" in the menu
3. Create New Deployment: Click "New Deployment" or "Create"
4. Select Integrations: Choose which of the 600+ integrations you want to enable
5. Configure Settings: Set up authentication and permissions as needed
6. Copy Deployment ID: Save the deployment ID for use in your code

Using Server Deployments in Code

Pass your deployment ID when creating a session:

metorial.withProviderSession(
  metorialAiSdk,
  {
    serverDeployments: ['your-deployment-id-here']
  },
  async session => {
    // Your AI logic here
  }
);

Using Multiple Deployments

You can use multiple deployments to give your AI access to different tool sets:

metorial.withProviderSession(
  metorialAiSdk,
  {
    serverDeployments: [
      'github-deployment-id',
      'slack-deployment-id',
      'calendar-deployment-id'
    ]
  },
  async session => {
    // AI can now access tools from all three deployments
  }
);

Best Practices

• Principle of Least Privilege: Only include integrations your app actually needs
• Separate Environments: Use different deployments for dev, staging, and production
• Organized Naming: Use clear, descriptive names like "Production-GitHub-Slack" or "Dev-All-Tools"
• Regular Audits: Review and update your deployments periodically

Finding Your Deployment ID

Lost your deployment ID? Find it in the Metorial dashboard:

1. Go to "Server Deployments"
2. Click on your deployment
3. Copy the ID from the deployment details page