Fastn Server
The Fastn server is a powerful, scalable platform that enables dynamic tool registration and execution based on API definitions. It seamlessly integrates with services like Claude.ai and Cursor.ai, providing a unified server solution for a wide range of tasks. With its robust architecture, Fastn delivers exceptional performance and flexibility for real-time, API-driven operations.
Getting Started
Package Installation (Recommended)
The easiest way to install the Fastn server is using pip:
After installation, you can run the server with:
When using the package installation, your configuration for AI assistants will look like:
**macOS/Linux:**
**Windows:**
To find the exact path of the installed fastn-server command:
- On macOS/Linux: `which fastn-server`
- On Windows: `where fastn-server`
Features
- **Integrated platform support** - Use services like Slack, Notion, HubSpot, and many more through the Fastn server after completing the simple setup
- **Logging support** - Comprehensive logging system
- **Error handling** - Robust error management for various scenarios
Step-by-Step Setup Guide
Step 1: Fastn Setup
- Login to your Fastn account
- Go to "Connectors" from the left sidebar
- Activate the service(s) you want to use by clicking on activate.
- Go to "Settings" from the left sidebar
- Click on "Generate API Key" and save it somewhere locally (e.g., in a notepad)
- Click on the copy button that exists on the top bar (left side of your profile)
- Copy your Workspace ID and save it as well
- All setup from Fastn is now complete
Step 2: Server Setup
Option 1: Use Package Installation (Recommended)
See the "Package Installation" section above.
Option 2: Manual Setup
Prerequisites
- Python 3.10 or higher
Quick Start
macOS
Windows
Step 3: Integration with AI Assistants
For Package Installation (Option 1)
- Find the path to your installed fastn-server: - On macOS/Linux: `which fastn-server` - On Windows: `where fastn-server`
- Configure your AI assistant with the path from step 1.
For Manual Installation (Option 2)
Integration with Claude On Mac OS
- Open the Claude configuration:
- Add the following configuration (replace placeholders with your actual values):
Integration with Cursor
- Open Cursor settings
- Click on "MCP" in the settings menu
- Click on "Add New"
- Add a name for your server (e.g., "fastn")
- Select "Command" as the type
- Add the following command (replace placeholders with your actual values):
Detailed Integration Instructions
For Claude
- Open the Claude configuration file: - Windows: `notepad "%APPDATA%\Claude\claude_desktop_config.json"` or `code "%APPDATA%\Claude\claude_desktop_config.json"` - Mac: `open -a TextEdit ~/Library/Application\ Support/Claude/claude_desktop_config.json` or `code ~/Library/Application\ Support/Claude/claude_desktop_config.json`
- Add the appropriate configuration JSON based on your installation method.
For Cursor
- Open Cursor settings
- Click on "MCP" in the settings menu
- Click on "Add New"
- Add a name for your server (e.g., "fastn")
- Select "Command" as the type
- Use the appropriate configuration based on your installation method
Troubleshooting
Package Structure Error
If you encounter an error like this during installation:
**Quick Fix:**
- Make sure `pyproject.toml` has the wheel configuration:
- Then install dependencies:
- Run the server:
Logging
Logs are output with timestamp, level, and message in the following format:
Support
For questions, issues, or feature requests, please visit:
- Documentation: [https://docs.fastn.ai](https://docs.fastn.ai)
- Community: [https://community.fastn.ai](https://community.fastn.ai)
License
This project is licensed under the terms included in the [LICENSE](LICENSE) file.