MCP (Model Context Protocol) servers enable your agents to interact with external services and tools. Palmier agent acts as a MCP client that support connecting to both local and remote MCP servers of your choice. We fully support and manage OAuth and token-based connection to your MCP servers, unlocking agent’s capabilities to integrate with your resources.

​
MCP Types

Palmier supports two main types of MCP servers, each with different connection methods and authentication options:

​
Local MCP Servers

Local servers run as processes inside the sandbox environment via stdio and cannot be accessed outside of the sandbox. You define the commands which are executed on sandbox start up. Characteristics:
  • Command-based execution (e.g., npx @example/mcp-server)
  • Runs locally for enhanced security
  • Direct process communication
  • No network connectivity required
  • Environment variables or argument flags for configuration
Best for:
  • Sensitive operations requiring local access
  • Development and testing environments
  • Services that don’t require remote API access

​
Remote MCP Servers

Remote servers connect over HTTP/HTTPS and support multiple transport protocols and authentication methods. Transport Protocols:
  • SSE (Server-Sent Events) - Real-time streaming communication
  • HTTP Streamable - HTTP-based streaming for continuous data flow
Authentication Methods:
  • OAuth - Secure OAuth 2.0 flow for services like Linear, Sentry.
  • PAT (Personal Access Token) - API token-based authentication
Characteristics:
  • HTTPS endpoint connection
  • Managed authentication flows
  • Automatic token refresh for OAuth
  • Managed personal tokens via Secrets
Best for:
  • Cloud-based services and APIs
  • Services requiring OAuth authentication
  • Production environments with managed authentication

​
MCP Server Library

The MCP Server Library contains a curated collection of pre-configured MCP servers for popular services across different categories:

Development & Code Management

GitHub, Linear, Notion

Project Management

Asana, Monday.com

Communication

Slack

Payment & Analytics

Stripe, Sentry

Databases

MongoDB, Neon, Supabase

AI & Analysis

Deepwiki, Sequentialthinking

Web Automation

Playwright

Cloud Services

AWS CloudWatch Logs

​
Setting Up MCP Servers

​
Using Pre-configured Servers

1

Browse the MCP Server Library

Use the search functionality to find the service you need
2

Add MCP to Your List

If the remote MCP servers require OAuth, we will redirect you to authorize. Otherwise, the MCP will be added to your list.
3

Configure Setting

Navigate to your MCP and configure the settings:
  • For MCP servers that require PAT, you will need to add the header Authorization: Bearer ${{ secrets.YOUR_KEY }}
  • You can also configure the environment variables or commands for your local MCP servers, or extra headers for your remote MCP servers.
4

Add MCP to your agent

Once the MCP setting is saved, you can now configure your custom agents to add these MCP servers as tools.

​
Creating Custom MCP Servers

You can also create your own custom MCP servers:

​
Authentication Methods

​
Best Practices

​
Agent Specialization Over Generalization

Avoid: Generic Agents with Many MCP Servers
  • Don’t create a single agent with 10+ MCP servers
  • Agents become overwhelmed with too many capabilities
  • Context switching between different tools reduces effectiveness
  • Harder to maintain and debug
Recommended: Specialized Agents with Focused MCP Abilities
  • Create multiple specific agents with 2-5 relevant MCP servers each
  • Each agent should have a clear, focused purpose
  • Better performance and more reliable results
  • Easier to maintain and optimize

​
Example Agent Configurations

Development Agent

Focus: Code management, issue tracking, error monitoring
  • GitHub MCP server
  • Linear MCP server
  • Sentry MCP server

Content Management Agent

Focus: Documentation, team communication
  • Notion MCP server
  • Slack MCP server

Business Operations Agent

Focus: Financial operations, project management
  • Stripe MCP server
  • Asana MCP server
  • Monday.com MCP server

​
Troubleshooting

​
Common Issues

​
Getting Help

Documentation

Check the “View Documentation” link for each MCP server for detailed setup instructions

Testing

Test connections individually before combining servers and monitor agent logs for detailed error messages