Skip to content

MCP_CONFIGURATION.md

Latest commit

 

History

History
98 lines (75 loc) · 3.22 KB

MCP_CONFIGURATION.md

File metadata and controls

98 lines (75 loc) · 3.22 KB

MCP Configuration Guide

This guide explains how to configure the PyAirbyte MCP Server for local use only.

Configuration File Location

The MCP configuration file is typically located at:

  • Cline/Claude Dev Extension: /Users/quintonwall/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  • Claude Desktop App: ~/Library/Application Support/Claude/claude_desktop_config.json

Configuration Format

For Local Server:

{
  "mcpServers": {
    "pyairbyte-mcp-server": {
      "command": "python",
      "args": ["/Users/quintonwall/code/airbyte-mcp/main.py"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      },
      "disabled": false
    }
  }
}

Environment Variables

MCP Configuration (Required)

  • OPENAI_API_KEY: Your OpenAI API key for accessing GPT models and file search functionality

.env File (Optional)

  • VECTOR_STORE_ID: OpenAI Vector Store ID for file search capabilities (if you have uploaded PyAirbyte documentation)
  • PORT: Port number for the server (defaults to 8000)

Getting Your OpenAI API Key

  1. Go to OpenAI Platform
  2. Sign in to your account or create a new one
  3. Navigate to the API Keys section
  4. Create a new API key
  5. Copy the key and add it to your MCP configuration

Example Complete Configuration

Here's an example of a complete MCP settings file with the PyAirbyte server configured:

{
  "mcpServers": {
    "pyairbyte-mcp-server": {
      "command": "python",
      "args": ["/Users/quintonwall/code/airbyte-mcp/main.py"],
      "env": {
        "OPENAI_API_KEY": "sk-proj-abc123..."
      },
      "disabled": false
    },
    "other-server": {
      "command": "node",
      "args": ["/path/to/other/server.js"],
      "disabled": false
    }
  }
}

Verification

After updating your MCP configuration:

  1. Restart your Cline/Claude application
  2. The server should automatically connect and initialize with your OpenAI API key
  3. Check the server logs for confirmation that the OpenAI client was initialized successfully
  4. You should see the generate_pyairbyte_pipeline tool available in your MCP tools

Security Notes

  • Never commit your API keys to version control
  • Keep your OpenAI API key secure and rotate it regularly
  • Monitor your OpenAI usage to avoid unexpected charges
  • The API key is only used for generating PyAirbyte pipeline code and documentation search

Troubleshooting

If the server fails to start:

  1. Check the file path: Ensure the path in args points to the correct location of main.py
  2. Verify Python installation: Make sure Python is available in your PATH
  3. Check dependencies: Ensure required packages are installed (pip install openai python-dotenv fastmcp)
  4. Validate API key: Test your OpenAI API key with a simple API call
  5. Check logs: Look for error messages in the MCP server logs

Migration from .env File

If you were previously using a .env file for configuration, you can now remove the OPENAI_API_KEY from the .env file and configure it through the MCP settings instead. The server will still fall back to environment variables if the MCP configuration doesn't provide the API key.