Skip to content

01-getting-started-and-core-setup.md

Latest commit

 

History

History
94 lines (64 loc) · 2.36 KB

01-getting-started-and-core-setup.md

File metadata and controls

94 lines (64 loc) · 2.36 KB
layout default
title Chapter 1: Getting Started and Core Setup
nav_order 1
parent Firecrawl MCP Server Tutorial

Chapter 1: Getting Started and Core Setup

Welcome to Chapter 1: Getting Started and Core Setup. In this part of Firecrawl MCP Server Tutorial: Web Scraping and Search Tools for MCP Clients, you will build an intuitive mental model first, then move into concrete implementation details and practical production tradeoffs.

This chapter gets Firecrawl MCP running with minimum viable configuration.

Learning Goals

  • launch Firecrawl MCP with cloud credentials
  • verify tool availability in your client
  • capture initial connectivity checks

Quick Start Command

env FIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y firecrawl-mcp

First-Run Checklist

  1. API key is valid
  2. client connects to server process
  3. at least one scrape/search call succeeds
  4. logs show no repeated auth or rate-limit failures

Source References

Summary

You now have a working Firecrawl MCP baseline.

Next: Chapter 2: Architecture, Transports, and Versioning

Source Code Walkthrough

src/types/fastmcp.d.ts

The FastMCP class in src/types/fastmcp.d.ts handles a key part of this chapter's functionality:

  ) => unknown | Promise<unknown>;

  export class FastMCP<Session = unknown> {
    constructor(options: {
      name: string;
      version?: string;
      logger?: Logger;
      roots?: { enabled?: boolean };
      authenticate?: (
        request: { headers: IncomingHttpHeaders }
      ) => Promise<Session> | Session;
      health?: {
        enabled?: boolean;
        message?: string;
        path?: string;
        status?: number;
      };
    });

    addTool(tool: {
      name: string;
      description?: string;
      parameters?: unknown;
      execute: ToolExecute<Session>;
    }): void;

    start(args?: TransportArgs): Promise<void>;
  }
}

This class is important because it defines how Firecrawl MCP Server Tutorial: Web Scraping and Search Tools for MCP Clients implements the patterns covered in this chapter.

How These Components Connect

flowchart TD
    A[FastMCP]
Loading