MCP Servers
Create, manage, and publish Model Context Protocol servers with A²D’s no-code tools.
Overview
All members of your organization can see and edit all MCP servers in that org. Each server card shows who created it (“Created by”). There is no per-server sharing; access is by organization membership only. Switch organizations in the sidebar to view another org’s servers.
MCP Servers in A²D provide three key components:
- Tools - Functions that AI agents can execute
- Resources - Data sources agents can access
- Prompts - Interaction templates for consistent behavior
Three Ways to Create Servers
Import from URL
Connect to existing HTTP-Streamable MCP endpoints:
- Automatic introspection of remote servers
- One-click import of tools, resources, and prompts
- Synchronization capabilities
- Extend with additional components
Best for: Integrating existing MCP servers
Import from OpenAPI
Convert REST APIs to MCP servers:
- Upload or paste OpenAPI 3.x specifications
- Automatic endpoint-to-tool conversion
- Request/response schema mapping
- Multiple specs per server
Best for: Wrapping REST APIs as MCP servers
Create from Scratch
Build custom mock servers:
- No-code tool schema builder
- Visual resource configuration
- Prompt argument builder
- Complete mock scenario support
Best for: Prototyping and testing
Key Features
Tool Management
- JSON schema builder for inputs/outputs
- Enable/disable individual tools
- Mock scenario configuration
- Real-time validation
Resource Management
- Resource templates and URIs
- Mock content configuration
- MIME type support
- Versioning
Prompt Management
- Argument definition
- Template configuration
- Example interactions
- Variable substitution
Mock Scenarios
Create realistic test responses:
- Conditional matching
- Multiple scenarios per tool
- JSON response configuration
- Test before publishing
Live MCP Endpoints
Every server gets a live endpoint:
- HTTP-Streamable transport
- JSON-RPC 2.0 protocol
- Real-time testing
- Ready for AI agents
Authentication
Secure your MCP endpoints:
- Bearer token authentication
- Basic authentication
- OAuth2 client credentials
- Auto-generated credentials
Server Lifecycle
Quick Actions
Create Your First Server
1. Navigate to MCP Servers
2. Click "+ Add MCP Design Spec"
3. Choose creation method
4. Configure server details
5. Add tools/resources/prompts
6. Test the endpoint
7. Publish to ExchangeCommon Operations
- Download Spec: Get JSON specification file
- Copy Endpoint: Copy MCP endpoint URL to clipboard
- Enable/Disable: Toggle components on/off
- Edit Metadata: Update server name, description, version
- Created by: See who created each server (on list cards)
- Delete: Remove server and all components
Best Practices
Naming Conventions
- Server Names: Use descriptive, kebab-case names (
weather-api-server) - Tool Names: Clear action verbs (
get_weather,search_products) - Resource URIs: Follow REST patterns (
weather://cities/SF)
Documentation
- Write clear, detailed descriptions (200+ characters)
- Provide examples for each tool
- Document expected inputs and outputs
- Include error scenarios in mocks
Testing
- Use the in-app Protocol Tester (Test tab on the server or sidebar) to discover and run tools
- Create multiple mock scenarios per tool
- Test with real MCP clients (Postman, Claude Desktop)
- Verify error handling
- Check compliance before publishing
Versioning
- Use semantic versioning (1.0.0, 1.1.0, 2.0.0)
- Document changes in descriptions
- Test backwards compatibility
- Coordinate with consumers
Server Status
Servers can have different statuses:
- Draft - Work in progress, not published
- Published - Available in Anypoint Exchange
- Archived - Deprecated but preserved
Compliance Checking
A²D validates servers against design rules:
- Description length requirements
- Tool naming standards
- Mock scenario completeness
- Provider information
Integration with Anypoint Exchange
Publish servers directly to Exchange:
- OAuth2 and Basic Auth support
- Asset metadata configuration
- Status tracking
- Version management
MCP Protocol Compliance
A²D implements MCP specification:
- HTTP-Streamable transport
- JSON-RPC 2.0 messaging
- Capability negotiation
- Standard error codes
Example: Weather API Server
Here’s a complete example of an MCP server:
Server: weather-api-server
Tools:
get_current_weather- Get current conditionsget_forecast- Get 7-day forecastsearch_cities- Find cities by name
Resources:
weather://cities- List of available citiesweather://alerts- Active weather alerts
Prompts:
weather_query- Template for asking about weather
Next Steps
- Creating Servers - Detailed creation guide
- Managing Tools - Tool configuration
- Mock Scenarios - Testing strategies
- Publishing - Publish to Anypoint Exchange
Need Help? See Troubleshooting or check the FAQ.