AITable

Servidor MCP AITable

Um servidor Model Context Protocol que fornece acesso de leitura e escrita ao AITable.ai. Este servidor permite que LLMs listem espaços, pesquisem nós, listem registros, criem registros e enviem anexos no AITable.ai.

Ferramentas

Nome da Ferramenta	Disponível	Descrição
list_spaces	✅	Busca todos os espaços de trabalho que o usuário autenticado atualmente tem permissão para acessar.
search_nodes	✅	Recupera nós com base em tipos específicos, permissões e consultas.
list_records	✅	Lê os registros de um banco de dados especificado com suporte a paginação, filtragem de campos e opções de ordenação.
get_fields_schema	✅	Retorna o esquema JSON de todos os campos dentro do banco de dados especificado.
create_record	✅	Cria um novo registro no banco de dados.
upload_attachment_via_url	✅	Envia um anexo para o servidor AITable usando sua URL web.
update_record	❌	TODO

Variáveis de Ambiente

• AITABLE_API_KEY: Seu token de acesso pessoal do AITable.
• AITABLE_BASE_URL: A URL base da API do AITable. O padrão é https://aitable.ai/fusion. Você pode defini-la como {YOUR_CUSTOM_BASE_URL} se estiver usando o APITable (a versão de código aberto do AITable).

Uso

Você pode usar este servidor em clientes MCP, como Claude Desktop, CherryStudio, etc.

Claude Desktop No caso do Claude Desktop, você precisa adicionar as seguintes informações de configuração à seção "mcpServers" do arquivo claude_desktop_config.json:

Para Linux, MacOS:

{
  "mcpServers": {
    "aitable": {
      "command": "npx",
      "args": [
        "-y",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/aitable-mcp-server"
      ],
      "env": {
        "AITABLE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Para Windows:

{
  "mcpServers": {
    "aitable": {
      "command": "npx",
      "args": [
        "-y",
        "D:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\aitable-mcp-server"
      ],
      "env": {
        "AITABLE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Substitua YOUR_API_KEY pelo seu token de acesso pessoal do AITable e /ABSOLUTE/PATH/TO/PARENT/FOLDER/aitable-mcp-server pelo caminho absoluto para a pasta pai deste repositório.

CherryStudio Se você estiver usando o CherryStudio como cliente MCP e sistema Windows, sua configuração deve ficar assim:

{
  "mcpServers": {
    "aitable": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "D:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\aitable-mcp-server"
      ],
      "env": {
        "AITABLE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Depuração

O inspetor MCP é uma ferramenta de desenvolvedor para testar e depurar servidores MCP.

Para inspecionar uma implementação de servidor MCP, não é necessário clonar o repositório do inspetor MCP. Em vez disso, use npx. Por exemplo, o servidor MCP AITable é construído em dist/index.js. Os argumentos são passados diretamente para o seu servidor, enquanto as variáveis de ambiente podem ser definidas usando a flag -e:

npx @modelcontextprotocol/inspector -e AITABLE_API_KEY={YOUR_API_KEY} node build/index.js

A outra maneira é clonar o repositório do inspetor MCP e conectar o servidor MCP AITable na interface do inspetor.

cd path/to/inspector/
npm start -- -e AITABLE_API_KEY={YOUR_API_KEY}