kintone

Servidor MCP para kintone

Servidor Model Context Protocol (MCP) para kintone. Este servidor permite que você explore e manipule dados do kintone usando ferramentas de IA, como o Claude Desktop!

Versão em japonês: a explicação em japonês está em README.ja.md.

2025-08-28 ANÚNCIO / Aviso

A Cybozu lançou o servidor MCP oficial do kintone! :tada:
Acredito que o papel deste projeto foi cumprido, então não adicionarei novos recursos. Por favor, use e contribua com o servidor MCP oficial!

A Cybozu lançou o servidor MCP oficial do kintone! :tada:
Acredito que o papel deste projeto foi cumprido, portanto não adicionarei novos recursos no futuro. Por favor, use o servidor MCP oficial!

Uso

1. Instalação

Baixe a versão mais recente na página de lançamentos. Você pode colocar o arquivo executável em qualquer lugar que desejar.

2. Configure o cliente MCP, como o Claude Desktop

Configure seu cliente para conectar ao servidor.

Para o Claude Desktop, edite o arquivo abaixo:

• MacOS/Linux: ~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Adicione a seguinte configuração à seção mcpServers:

{
  "mcpServers": {
    "kintone": {
      "command": "C:\\path\\to\\mcp-server-kintone.exe",
      "env": {
        "KINTONE_BASE_URL": "https://<domain>.cybozu.com",
        "KINTONE_USERNAME": "<your username>",
        "KINTONE_PASSWORD": "<your password>",
        "KINTONE_API_TOKEN": "<your api token>, <another api token>, ...",
        "KINTONE_ALLOW_APPS": "1, 2, 3, ...",
        "KINTONE_DENY_APPS": "4, 5, ..."
      }
    }
  }
}

Variáveis de ambiente:

• KINTONE_BASE_URL: (Obrigatório) A URL base do seu kintone.
• KINTONE_USERNAME: Seu nome de usuário para o kintone.
• KINTONE_PASSWORD: Sua senha para o kintone.
• KINTONE_API_TOKEN: Token de API separado por vírgulas para o kintone. Você precisa definir KINTONE_USERNAME e KINTONE_PASSWORD ou KINTONE_API_TOKEN.
• KINTONE_ALLOW_APPS: Uma lista separada por vírgulas de IDs de aplicativos aos quais você deseja permitir acesso. Por padrão, todos os aplicativos são permitidos.
• KINTONE_DENY_APPS: Uma lista separada por vírgulas de IDs de aplicativos aos quais você deseja negar acesso. A negação tem prioridade maior que a permissão.

Talvez seja necessário reiniciar o Claude Desktop para aplicar as alterações.

3. Comece a usar

Agora você pode interagir com o kintone usando suas próprias ferramentas de IA!

Por exemplo, você pode dizer:

• "Qual é o status mais recente do projeto do Cliente A?"
• "Atualize o progresso do Projeto B para 50%."
• "Mostre-me os projetos que estão atrasados."