Search anything...
K
Back to Docs
  • Introduction
  • Quick Start
  • Account Setup
  • AI Studio
  • Chat
  • Agents
  • Voice
  • MCP Servers
  • Workflows
  • Authentication
  • Studio API
  • Chat API
  • Agents API
  • Voice API
  • Workflows API
  • Webhooks
  • Error Codes
  • Creating Custom Agents
  • MCP Integration
  • Building Workflows
  • Prompt Engineering
  • Team Management
  • Billing & Plans
  • Usage Monitoring
  • Single-Tenant Cloud
  • Private VPC Deployment
  • SSO Configuration
  • Security Policies
  • Compliance
  • Troubleshooting
  • API Versioning
DocsFeaturesMCP Servers

MCP Servers

Connect external tools and services to enhance AI capabilities

MCP (Model Context Protocol) Servers extend Girard's capabilities by connecting AI to external tools and services. Enable your AI assistants to query databases, search the web, interact with APIs, and more.

Overview

MCP Servers provide:

  • Tool Integration - Connect AI to external services
  • Extended Capabilities - Database queries, file access, API calls
  • Modular Design - Enable only what you need
  • Secure Connections - API key management

What is MCP?

Model Context Protocol (MCP) is a standardized way for AI models to interact with external tools and services. When you enable an MCP server:

  1. The AI gains access to the server's tools
  2. Tools appear as functions the AI can call
  3. AI decides when to use tools based on your request
  4. Tool results are incorporated into responses

Example Flow

User: "How many orders did we get last month?"

AI: [Recognizes need for database query]
    [Calls postgres.query_database tool]
    [Receives: 1,247 orders]

AI: "Based on your database, you received 1,247
    orders last month."

MCP Marketplace

Accessing the Marketplace

  1. Navigate to MCP in the sidebar
  2. Browse the Marketplace tab
  3. View available server templates
  4. Click Install to add a server

Available Servers

Database Servers

ServerDescriptionTools
PostgreSQLConnect to PostgreSQL databasesquery, list tables, describe schema
SQLiteLocal SQLite database accessquery, list tables

File & Storage

ServerDescriptionTools
FilesystemLocal file system accessread, write, list directory
Google DriveGoogle Drive integrationlist files, read files

Development Tools

ServerDescriptionTools
GitHubGitHub repository accesssearch repos, issues, PRs
DockerContainer managementlist, run containers

Communication

ServerDescriptionTools
SlackSlack workspace integrationsend messages, list channels
NotionNotion workspace accesssearch, read, create pages

AI Services

ServerDescriptionTools
Web SearchInternet search capabilitysearch, fetch URLs
PuppeteerBrowser automationnavigate, screenshot, click
MemoryPersistent AI memorystore, retrieve, search

Cloud Providers

ServerDescriptionTools
AWSAmazon Web ServicesS3, EC2 operations

Installing Servers

From Marketplace

  1. Find the server you want
  2. Click Install
  3. Configure connection settings:
    • Server URL (if external)
    • API key or credentials
  4. Click Connect
  5. Server appears in Installed tab

Configuration Fields

FieldDescriptionRequired
NameDisplay nameYes
URLServer endpointYes
API KeyAuthentication keyDepends

Example: PostgreSQL Setup

Name: Production Database
URL: postgresql://user:pass@host:5432/database
API Key: (not required for direct connection)

Example: GitHub Setup

Name: Company GitHub
URL: https://api.github.com
API Key: ghp_xxxxxxxxxxxxx (Personal Access Token)

Server Tools Reference

PostgreSQL Tools

query_database

Execute SQL queries against the database.

Parameters:
- query (required): SQL query string
- params (optional): Query parameters as JSON

list_tables

List all tables in the database.

Parameters:
- schema (optional): Schema name (default: public)

describe_table

Get the schema of a specific table.

Parameters:
- table_name (required): Name of the table

Filesystem Tools

read_file

Read the contents of a file.

Parameters:
- path (required): Path to the file

write_file

Write content to a file.

Parameters:
- path (required): Path to the file
- content (required): Content to write

list_directory

List contents of a directory.

Parameters:
- path (required): Path to the directory

GitHub Tools

search_repositories

Search for GitHub repositories.

Parameters:
- query (required): Search query
- limit (optional): Max results (default: 10)

get_repository

Get details about a repository.

Parameters:
- owner (required): Repository owner
- repo (required): Repository name

list_issues

List issues in a repository.

Parameters:
- owner (required): Repository owner
- repo (required): Repository name
- state (optional): open, closed, or all

create_issue

Create a new issue.

Parameters:
- owner (required): Repository owner
- repo (required): Repository name
- title (required): Issue title
- body (optional): Issue body

Web Search Tools

search_web

Search the web for information.

Parameters:
- query (required): Search query
- num_results (optional): Number of results

fetch_url

Fetch and extract content from a URL.

Parameters:
- url (required): URL to fetch

Memory Tools

store_memory

Store information in persistent memory.

Parameters:
- key (required): Memory key
- value (required): Value to store

retrieve_memory

Retrieve information from memory.

Parameters:
- key (required): Memory key

search_memory

Search stored memories.

Parameters:
- query (required): Search query

list_memories

List all stored memories.

Parameters: (none)

Using MCP in Chat & Agents

Enabling in Chat

  1. Open the Chat interface
  2. Expand MCP Tools in the sidebar
  3. Toggle servers on/off
  4. Enabled servers show checkmarks

Enabling in Agents

  1. Edit or create an agent
  2. Scroll to MCP Servers section
  3. Toggle desired servers
  4. Save the agent

Tool Usage Examples

Database Query:

User: Show me our top 10 customers by revenue

AI: [Calls postgres.query_database]
    SELECT customer_name, SUM(revenue) as total
    FROM orders
    GROUP BY customer_name
    ORDER BY total DESC
    LIMIT 10;

AI: Here are your top 10 customers by revenue:
    1. Acme Corp - $125,000
    2. Tech Industries - $98,500
    ...

File Operations:

User: Read the config.json file and explain the settings

AI: [Calls filesystem.read_file with path "config.json"]

AI: I've read your config.json file. Here's what each
    setting does:
    - "apiEndpoint": The URL for API calls...

Web Research:

User: Find recent articles about AI regulations in Europe

AI: [Calls web-search.search_web]

AI: I found several recent articles about EU AI regulations:
    1. "EU AI Act Implementation Timeline" - TechNews
    2. "What Companies Need to Know" - Reuters
    ...

External Servers

Adding Custom MCP Servers

For self-hosted or third-party MCP servers:

  1. Go to MCP > External tab
  2. Click Add External Server
  3. Enter server details:
    • Name
    • URL endpoint
    • API key (if required)
  4. Click Connect

Server Requirements

External MCP servers must:

  • Implement the MCP protocol
  • Be accessible from your network
  • Support HTTPS (recommended)
  • Provide tool definitions

Managing Servers

Viewing Installed Servers

  1. Navigate to MCP > Installed tab
  2. See all connected servers
  3. View status (connected/disconnected/error)

Server Status

StatusDescription
ConnectedServer is available and working
DisconnectedServer not currently connected
ErrorConnection or authentication failed
ConnectingAttempting to establish connection

Removing Servers

  1. Find the server in Installed tab
  2. Click Remove or the trash icon
  3. Confirm removal
  4. Server is disconnected and removed

Security Best Practices

API Key Management

  • Never share API keys publicly
  • Use environment variables when possible
  • Rotate keys periodically
  • Use least privilege - minimal permissions

Network Security

  • Use HTTPS for all connections
  • Whitelist IPs if supported
  • Monitor access logs
  • Audit permissions regularly

Data Considerations

  • Be mindful of data sent to tools
  • Review tool permissions before enabling
  • Consider data residency requirements
  • Audit tool usage in logs

Troubleshooting

Server Won't Connect

  1. Verify the URL is correct
  2. Check API key validity
  3. Ensure network connectivity
  4. Review server logs

Tools Not Working

  1. Confirm server is connected
  2. Check tool is enabled in Chat/Agent
  3. Verify parameter format
  4. Review error messages

Slow Responses

  1. Check server response time
  2. Reduce concurrent tool calls
  3. Optimize queries
  4. Consider server location

Previous: Voice | Next: Workflows

Previous
Voice
Next
Workflows