Server deployments in Metorial define which integrations your AI agents can access. This guide explains what they are and how to use them.

What are Server Deployments?

A server deployment is a configuration that specifies:

• Which integrations (tools) are available to your agent
• Authentication credentials for those integrations
• Access permissions and rate limits

Think of server deployments as pre-configured bundles of integrations that you can easily connect to your AI agents.

How to Get Server Deployment IDs

1. Log into your Metorial dashboard
2. Navigate to the "Server Deployments" section
3. Create a new deployment or select an existing one
4. Copy the deployment ID - it looks like a unique identifier string

Using Server Deployments in Code

Pass your server deployment ID when creating a provider session:

await metorial.withProviderSession(
  metorialGoogle,
  { serverDeployments: ['your-server-deployment-id'] },
  async session => {
    // Your agent code here
  }
);

Multiple Deployments

You can use multiple server deployments if your agent needs access to different sets of integrations:

await metorial.withProviderSession(
  metorialGoogle,
  { 
    serverDeployments: [
      'deployment-id-1',
      'deployment-id-2'
    ] 
  },
  async session => {
    // Agent has access to integrations from both deployments
  }
);

Common Use Cases

• Development vs Production: Use separate deployments with different credentials
• Feature-Specific Access: Create deployments for different agent capabilities
• Team Separation: Different deployments for different teams or projects

Security Note

Server deployments help keep your integration credentials secure - they're stored on Metorial's servers, not in your code.